Write-IniFileValue

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

Write-IniFileValue

Synopsis

Modify INI File

Syntax

Write-IniFileValue [-FileName] <String> [-SectionName] <String> [-KeyName] <String> [-ConfirmChanges] [-ContinueOnError] [-Wow64] [-Value] <String> [[-Action] <String>] [[-Context] <String>] [<CommonParameters>]

Description

This command allows you to change a value in an INI file.

Parameters

-Action <String>

Option for the command execution.

Required	False
Position	4
Accepts pipeline input	False

-ConfirmChanges <SwitchParameter>

If checked, the user will be prompted to confirm the change to an existing entry.

Required	False
Position	Named
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

-FileName <String>

Enter the name of the file with the extension ".INI"; this can be either an existing file or a new file (that will be created).

Required	True
Position	0
Accepts pipeline input	False

-KeyName <String>

Enter the name of the key omitting an "equals" sign (=); this entry can refer either to an existing key or to a new key that will be created.
The section and all the keys contained will be deleted if you specify an empty string.

Required	True
Position	2
Accepts pipeline input	False

-SectionName <String>

Enter the name of the section omitting the square brackets; this can be either an existing section or a new section that will be created.

Required	True
Position	1
Accepts pipeline input	False

-Value <String>

Enter the value of the key.
The key will be deleted if you specify an empty string.

Required	True
Position	3
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".