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

<CommonParameters>

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