Add-EnvironmentPath

PackageDeployment Module Help	Package Deployment Module
Add-EnvironmentPath Cmdlet	Version 4.0.0.5

Add-EnvironmentPath

Synopsis

Append Path in AUTOEXEC.BAT or Windows NT Registry

Syntax

Add-EnvironmentPath [-Path] <String> [[-Position] <String>] [[-DialogTitle] <String>] [-ConfirmChanges] [-ContinueOnError] [-Wow64] [[-Context] <String>] [<CommonParameters>]

Description

Use this command to append the path statement in the AUTOEXEC.BAT file.

Parameters

-ConfirmChanges <SwitchParameter>

If checked, all changes must be confirmed. When the installation package is executed, a dialog box will be displayed, containing two text boxes: the entry in the first text box shows the current version of the AUTOEXEC.BAT file and the second text box contains the proposed new version (You cannot access this dialog box from Windows NT).

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	3
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

-DialogTitle <String>

If you want to inform the user about modifications to the path statement, you must enter the name of the application for which you extended the path statement. A message box will be displayed when the installation package is executed.

Required	False
Position	2
Accepts pipeline input	False

-Path <String>

Enter the directory or directories you want to add to the path statement. Check the option to ensure that the extension is inserted at the beginning of the statement.

Required	True
Position	0
Accepts pipeline input	False

-Position <String>

Enter the line in the AUTOEXEC.BAT file before or after which the new path statement should be placed. You can use wildcards here.

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

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