TroubleChute Logo
< Go Back

TroubleChute Script Hub

Currently viewing: PowerShell/Modules/New-Shortcut.psm1

NOTE: The following code may be out-of-date compared to GitHub, but is all pulled from GitHub every hour or so.

When shortlinks are used (filename as subdomain), code used by PowerShell and other interactions with this site is served from GitHub.

(Right-click -> Download the button below to save the file)

Last modified: 2023-04-12T20:59:52.000+02:00

# Copyright (C) 2023 TroubleChute (Wesley Pyburn)
# Licensed under the GNU General Public License v3.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#    This program is free software: you can redistribute it and/or modify
#    it under the terms of the GNU General Public License as published by
#    the Free Software Foundation, either version 3 of the License, or
#    (at your option) any later version.
#    This program is distributed in the hope that it will be useful,
#    but WITHOUT ANY WARRANTY; without even the implied warranty of
#    GNU General Public License for more details.
#    You should have received a copy of the GNU General Public License
#    along with this program.  If not, see .
# ----------------------------------------
# This function helps create a shortcut for the provided target, with a workingpath and shortcutname.
# ----------------------------------------

   Creates a desktop shortcut for a given target with optional customizations.

   The New-Shortcut function creates a desktop shortcut for the specified target with options for customizing the working directory, arguments, and icon. It takes two mandatory parameters - ShortcutName and TargetPath - and three optional parameters - WorkingDirectory, Arguments, and IconLocation.

.Parameter ShortcutName
   The name of the shortcut file to be created on the desktop, without the ".lnk" extension.

.Parameter TargetPath
   The path to the target file or application.

.Parameter WorkingDirectory
   The working directory for the target application when the shortcut is launched. If not specified, the function will set it to the same directory as the target file or application.

.Parameter Arguments
   Optional command-line arguments to pass to the target application when the shortcut is launched.

.Parameter IconLocation
   The optional path to the icon file to be used for the shortcut. The format should be "path, iconIndex", where "path" is the path to the file containing the icon, and "iconIndex" is the zero-based index of the icon in the file.

   New-Shortcut -ShortcutName "MyApp" -TargetPath "C:\Program Files\MyApp\MyApp.exe" -Arguments "/config C:\configs\myconfig.conf" -IconLocation "C:\Program Files\MyApp\MyApp.ico, 0"

   This example creates a desktop shortcut named "MyApp" that targets the "MyApp.exe" application, passes a command-line argument for a config file, and uses a custom icon.
function New-Shortcut {
        [Parameter(Mandatory = $true)]

        [Parameter(Mandatory = $true)]

        [Parameter(Mandatory = $false)]

        [Parameter(Mandatory = $false)]

        [Parameter(Mandatory = $false)]

    # Set the working directory to the target path location if not provided
    if (-not $WorkingDirectory) {
        $WorkingDirectory = (Get-Item -Path (Resolve-Path $TargetPath)).Directory.FullName

    # Create the desktop shortcut
    $shortcutPath = Join-Path -Path ([Environment]::GetFolderPath("Desktop")) -ChildPath "$ShortcutName.lnk"
    $shell = New-Object -ComObject WScript.Shell
    $shortcut = $shell.CreateShortcut($shortcutPath)
    if ($Arguments) { $shortcut.Arguments = $Arguments }
    if ($IconLocation) {
      $fullIcoPath = (Resolve-Path -Path $IconLocation).Path
      $shortcut.IconLocation = $fullIcoPath
    $shortcut.TargetPath = (Resolve-Path $TargetPath).Path
    $shortcut.WorkingDirectory = (Resolve-Path $WorkingDirectory).Path

TCNO TechNobo / TroubleChute © Wesley Pyburn (TroubleChute)
Support Me Privacy Policy Cookies Policy Terms of Service Contact