startmenu.ps1
|
. "$PSScriptRoot\shortcut.ps1" $wshShell = New-Object -ComObject WScript.Shell $allUsersProgramsPath = $wshShell.SpecialFolders("AllUsersPrograms") # https://www.vbsedit.com/html/a239a3ac-e51c-4e70-859e-d2d8c2eb3135.asp # $windowStyleDefault = 1 $windowStyleMaximized = 3 $windowStyleMinimized = 7 function Get-StartMenuProgramsPath { <# .SYNOPSIS Returns the path to Start Menu > Programs. .DESCRIPTION Returns the path to the All Users Start Menu Programs folder. .OUTPUTS string - Path to the All Users Start Menu Programs folder. #> [CmdletBinding()] param () return $allUsersProgramsPath } function New-StartMenuProgramsFolder { <# .SYNOPSIS Creates a new folder in Start Menu > Programs. .DESCRIPTION Creates a new folder in the All Users Start Menu Programs folder. .PARAMETER Name The name of the folder in the Start Menu > Programs folder. .OUTPUTS string - Path to the newly created folder in the All Users Start Menu Programs folder. #> [CmdletBinding(SupportsShouldProcess)] param ( [Parameter(Mandatory = $true)] [Alias("AppName")] # DEPRECATED! [Alias("Folder", "Group")] [string] $Name ) $shortcutFolderName = "$allUsersProgramsPath\$Name" if ($PSCmdlet.ShouldProcess($shortcutFolderName, "Create folder")) { New-Item -ItemType Directory $shortcutFolderName -Force | Out-Null } return $shortcutFolderName } function New-StartMenuShortcut { <# .SYNOPSIS Creates a new shortcut in Start Menu > Programs. .DESCRIPTION Creates a new shortcut in the All Users Start Menu Programs folder. .PARAMETER Name The name of the application. This will be used as the name of the shortcut in the Start Menu > Programs folder. .PARAMETER Folder The name of the folder in the Start Menu > Programs folder. Default: $Name .PARAMETER Executable The path to the executable. .PARAMETER Arguments The arguments to pass to the executable. .PARAMETER Icon The path to the icon file to use for the shortcut. .OUTPUTS string - Path to the newly created shortcut in the All Users Start Menu Programs folder. #> [CmdletBinding(SupportsShouldProcess)] param ( [Parameter(Mandatory = $false)] [Alias("App", "AppName")] [string] $Name, [Parameter(Mandatory = $false)] [Alias("Group")] [string] $Folder, [Parameter(Mandatory = $true)] [string] $Executable, [Parameter(Mandatory = $false)] [string] $Arguments, [Parameter(Mandatory = $false)] [Alias("IconLocation")] [string] $Icon ) # infer the shortcut name $shortcutName = if ($Name) { $Name } else { ((Get-Item $Executable).BaseName) } $folderName = if ($Folder) { $Folder } else { $shortcutName } $shortcutFolder = New-StartMenuProgramsFolder -Name $folderName $shortcutPath = "$shortcutFolder\$shortcutName.lnk" $shortcut = $wshShell.CreateShortcut($shortcutPath) $shortcut.TargetPath = $Executable $shortcut.Arguments = $Arguments If ($Icon) { $shortcut.IconLocation = "$Icon,0" } if ($PSCmdlet.ShouldProcess($shortcutPath, "Create shortcut")) { $shortcut.Save() } return $shortcutPath } function New-PowershellStartMenuShortcut { <# .SYNOPSIS Creates a new shortcut that runs a PowerShell command in Start Menu > Programs. .DESCRIPTION Creates a new shortcut that runs a PowerShell command in the All Users Start Menu Programs folder. .PARAMETER Command The PowerShell command to run. .PARAMETER Name The name of the shortcut in the Start Menu > Programs folder. .PARAMETER Folder The name of the folder in Start Menu > Programs to create the shortcut in. If not specified, the shortcut is created directly in Start Menu > Programs. .PARAMETER RunAsAdministrator Whether to run the PowerShell command as an administrator. .PARAMETER Visible Whether to show the PowerShell window when the shortcut is run. .PARAMETER Maximized Whether to maximize the PowerShell window when the shortcut is run. .PARAMETER KeepOpen Whether to keep the PowerShell window open after the command has finished running. .PARAMETER Icon The path to the icon file to use for the shortcut. .OUTPUTS string - Path to the newly created shortcut in the All Users Start Menu Programs folder. #> [CmdletBinding(SupportsShouldProcess)] param ( [Parameter(Mandatory = $true)] [Alias("Script")] [string] $Command, [Parameter(Mandatory = $true)] [Alias("App", "AppName")] [string] $Name, [Parameter(Mandatory = $false)] [Alias("Group", "GroupName")] [string] $Folder, [Parameter(Mandatory = $false)] [Alias("Administrator", "Admin", "Elevate")] [switch] $RunAsAdministrator = $false, [Parameter(Mandatory = $false)] [switch] $Visible = $false, [Parameter(Mandatory = $false)] [switch] $Maximized = $false, [Parameter(Mandatory = $false)] [Alias("NoExit")] [switch] $KeepOpen = $false, [Parameter(Mandatory = $false)] [Alias("IconLocation")] [string] $Icon ) $shortcutFolder = if ($Group) { New-StartMenuProgramsFolder -Name $Group } else { Get-StartMenuProgramsPath } $arguments = @() if ($KeepOpen) { $arguments += "-NoExit" } $arguments += "-Command `"$Command`"" $shortcutPath = "$shortcutFolder\$Name.lnk" $shortcut = $wshShell.CreateShortcut($shortcutPath) $shortcut.TargetPath = "pwsh" $shortcut.Arguments = $arguments -join ' ' if (-not $Visible) { $shortcut.WindowStyle = $windowStyleMinimized } if ($Maximized) { $shortcut.WindowStyle = $windowStyleMaximized } if ($Icon) { $shortcut.IconLocation = "$Icon,0" } if ($PSCmdlet.ShouldProcess($shortcutPath, "Create shortcut")) { $shortcut.Save() } if ($RunAsAdministrator) { Set-ShortcutRunAsAdministrator $shortcutPath } return $shortcutPath } |