PackageDeployment Module Help

Package Deployment Module

Write-IniFileValue Cmdlet

Version 4.0.0.5

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 in Service context.
Computer: Execution under user account; logging in HKEY_CURRENT_MACHINE, i.e. for the computer.
ComputerPerService: Execution in service context; 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>

By default, the PackageDeployment module assumes to run in a 64-bit PowerShell process on 64-bit systems, and therefore defaults to the 64-bit application location (if different from the 32-bit application location) for file and registry accesses. If you want to access the 32-bit counterparts (in the file system %WinDir%\SysWOW64 instead of %WinDir%\System32, in the registry HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node instead of HKEY_LOCAL_MACHINE\SOFTWARE), use the -Wow64 switch.

Required

False

Position

Named

Accepts pipeline input

False

<CommonParameters>

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