PoshCode Archive  Artifact [48891a2cf0]

Artifact 48891a2cf063442004e94ef5539db65541f98453285d414967a10255e856924d:

• File New-Shortcut.ps1 — part of check-in [e7d2555c6f] at 2018-06-10 13:11:42 on branch trunk — This is a Powershell wrapper around the CreateShortCut method of the WScript.Shell COM object. I’ve added a feature to set the “Run as Administrator” flag. This feature is used on OS versions with UAC. (user: Andy Arismendi size: 2555)

# encoding: ascii
# api: powershell
# title: New-Shortcut
# description: This is a Powershell wrapper around the CreateShortCut method of the WScript.Shell COM object. I’ve added a feature to set the “Run as Administrator” flag. This feature is used on OS versions with UAC.
# version: 0.1
# type: script
# author: Andy Arismendi
# license: CC0
# x-poshcode-id: 2513
# x-archived: 2015-08-28T21:51:22
# x-published: 2011-02-18T20:03:00
#
#
[CmdletBinding()]
param (	
	[parameter(Mandatory=$true)]
	[ValidateScript( {[IO.File]::Exists($_)} )]
	[System.IO.FileInfo] $Target,
	
	[ValidateScript( {[IO.Directory]::Exists($_)} )]
	[System.IO.DirectoryInfo] $OutputDirectory,
	
	[string] $Name,
	[string] $Description,
	
	[string] $Arguments,
	[System.IO.DirectoryInfo] $WorkingDirectory,
	
	[string] $HotKey,
	[int] $WindowStyle = 1,
	[string] $IconLocation,
	[switch] $Elevated
)

try {
	#region Create Shortcut
	if ($Name) {
		[System.IO.FileInfo] $LinkFileName = [System.IO.Path]::ChangeExtension($Name, "lnk")
	} else {
		[System.IO.FileInfo] $LinkFileName = [System.IO.Path]::ChangeExtension($Target.Name, "lnk")
	}
	
	if ($OutputDirectory) {
		[System.IO.FileInfo] $LinkFile = [IO.Path]::Combine($OutputDirectory, $LinkFileName)
	} else {
		[System.IO.FileInfo] $LinkFile = [IO.Path]::Combine($Target.Directory, $LinkFileName)
	}

	$wshshell = New-Object -ComObject WScript.Shell
	$shortCut = $wshShell.CreateShortCut($LinkFile) 
	$shortCut.TargetPath = $Target.Name
	$shortCut.WindowStyle = $WindowStyle
	$shortCut.Description = $Description
	$shortCut.WorkingDirectory = $WorkingDirectory
	$shortCut.HotKey = $HotKey
	$shortCut.Arguments = $Arguments
	if ($IconLocation) {
		$shortCut.IconLocation = $IconLocation
	}
	$shortCut.Save()
	#endregion

	#region Elevation Flag
	if ($Elevated) {
		$tempFileName = [IO.Path]::GetRandomFileName()
		$tempFile = [IO.FileInfo][IO.Path]::Combine($LinkFile.Directory, $tempFileName)
		
		$writer = new-object System.IO.FileStream $tempFile, ([System.IO.FileMode]::Create)
		$reader = $LinkFile.OpenRead()
		
		while ($reader.Position -lt $reader.Length)
		{		
			$byte = $reader.ReadByte()
			if ($reader.Position -eq 22) {
				$byte = 34
			}
			$writer.WriteByte($byte)
		}
		
		$reader.Close()
		$writer.Close()
		
		$LinkFile.Delete()
		
		Rename-Item -Path $tempFile -NewName $LinkFile.Name
	}
	#endregion
} catch {
	Write-Error "Failed to create shortcut. The error was '$_'."
	return $null
}
return $LinkFile