New-Link

PackageDeployment Module Help	Package Deployment Module (DSM eScript Commands)
New-Link Cmdlet	Version 1.0.0.3

New-Link

Synopsis

Create Shell Link

Syntax

New-Link [-Description] <String> [-CommandLine] <String> [[-WorkingDirectory] <String>] [-ComputerRelatedLink] [-ContinueOnError] [-ManageUserPortion] [-RunMinimized] [-Wow64] [[-Icon] <String>] [[-Folder] <String>] [[-Context] <String>] [<CommonParameters>]

Description

Use this command to create a link.

Parameters

-CommandLine <String>

Displays the location and name (including the file name extension and required parameters) of the program file.

Required	True
Position	1
Accepts pipeline input	False

-ComputerRelatedLink <SwitchParameter>

Guarantees that the link is available to all users of a computer (e.g. by storing in the All Users profile).

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

-Description <String>

Describes the link; the text will appear below the link.

Required	True
Position	0
Accepts pipeline input	False

-Folder <String>

Specifies the location where you want to create the link. The actual paths are read from the registry key: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders.
Specifies the name of the folder where you want to create the link. If this specific folder does not yet exist, it will be created.

Required	False
Position	4
Accepts pipeline input	False

-Icon <String>

Displays the program icon. The name of the symbol file must not contain a comma.

Required	False
Position	3
Accepts pipeline input	False

-ManageUserPortion <SwitchParameter>

ensures that the software's computer portion is installed computer-related together with this link. The user portion will be post-installed as soon as the user clicks this link the first time.

Required	False
Position	Named
Accepts pipeline input	False

-RunMinimized <SwitchParameter>

specifies how you want the window to display the item when you open the link: In a standard window, on a full screen (maximized), or as a button on the task bar (minimized).

Required	False
Position	Named
Accepts pipeline input	False

-WorkingDirectory <String>

Specifies the path to the program's working directory.

Required	False
Position	2
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".