New-Link

PackageDeployment Module Help	Package Deployment Module
New-Link Cmdlet	Version 2.1.0.0

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

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

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".