Write-RegistryMultiString

PackageDeployment Module Help	Package Deployment Module (DSM eScript Commands)
Write-RegistryMultiString Cmdlet	Version 1.0.0.3

Write-RegistryMultiString

Synopsis

Change Registry MULTI_SZ Value

Syntax

Write-RegistryMultiString [-KeyPath] <String> [[-ValueName] <String>] [[-Value] <String[]>] [-ContinueOnError] [-Wow64] [[-Action] <String>] [[-Position] <String>] [[-Context] <String>] [<CommonParameters>]

Description

Use this command to change or extend a registry Multi_SZ value.This command allows you to create, delete and modify REG_Multi_SZ values. When performing an analysis, NetInstall Spy records changes to these values and automatically creates the required command.
Multi_SZ-values: ClosedBackground information.The registry contains string values and also multipart string values identified as REG_MULTI_SZ values in the registry editor. These are used, for example, when logging an installation package.
Please be very careful when using this command!Changing Multi_SZ values can seriously damage your operating system!
If an error occurs while running the command, the script stops. If you want to continue the script if there is an error, enable the setting Continue script despite error in the Script Editor

Parameters

-Action <String>

Set: Replace values.
SetAt: Replace values from positioning given below.
Prepend: Insert values at the beginning.
Append: Insert values at the end.
InsertAscending: Insert values in alphabetical order.
InsertDescending: Insert values in reverse alphabetical order.
InsertAt: Insert values at position given below.
Remove: Delete values from existing string.

Required	False
Position	3
Accepts pipeline input	False

-Context <String>

User: Execution under user account; logging in HKEY_CURRENT_USER, i.e. for the user.
UserPerService: User-related command, execution with DSM Runtime Service.
Computer: Execution under user account; logging in HKEY_CURRENT_MACHINE, i.e. for the computer.
Computer: Execution with DSM Runtime Service; logging in HKEY_LOCAL_MACHINE, i.e. for the computer.

Required	False
Position	5
Accepts pipeline input	False

-ContinueOnError <SwitchParameter>

Continues script execution in spite of errors in the respective command

Required	False
Position	Named
Accepts pipeline input	False

-KeyPath <String>

Specify the registry key (branch) you want to change.

Required	True
Position	0
Accepts pipeline input	False

-Position <String>

Position.

Required	False
Position	4
Accepts pipeline input	False

-Value <String[]>

The values to be specified. The action to be performed for the respective value can be specified via the radio buttons.

Required	False
Position	2
Accepts pipeline input	False

-ValueName <String>

Either the default value of the key or the name of a different value. If this is present on the workstation, it can be selected

Required	False
Position	1
Accepts pipeline input	False

-Wow64 <SwitchParameter>

For reasons of compatibilty, Ivanti DSM maps file and registry access to the default storage location for 32 bit applications (provided that the storage location differs from that of 64-bit applications). File access: whenever a 32-bit application attempts to access %windir%\System32, the access is redirected to %windir%\SysWOW64. Registry commands: when accessing HKEY_LOCAL_MACHINE\SOFTWARE the calls are redirected to HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node. The x64-switch stops this redirection of file and registry accesses when running the script command on a x64 computer; the eScript command runs on the specified path. CallScript command: the script runs in a 64-bit process.

Required	False
Position	Named
Accepts pipeline input	False

For more information about common parameters, type "Get-Help about_CommonParameters".