# Create Shortcut

> Creates a shortcut on the desktop for a specified target file or application, with options for customizing the shortcut's name, icon, and arguments.

Source: https://docs.capaone.com/capaone/application-manager/powerbricks/create-shortcut/  
Product: CapaOne — a separate CapaSystems product; do not apply this page to any other.

Creates a shortcut on the desktop for a specified target file or application, with options for customizing the shortcut's name, icon, and arguments.

## Parameters

#### Literal Path
*Required*

Specifies the full path of the shortcut to create, including file name and extension (.lnk or .url). Example: C:\Users\Public\Desktop\MyApp.lnk

#### Target Path
*Required*

Specifies the file system path or URL the shortcut will point to.

#### Arguments
*Optional*

Optional command-line arguments passed to the target when the shortcut is launched. [Not applicable for URL shortcuts.]

#### Icon Location
*Optional*

Specifies the path to the file containing the icon (e.g., .ico, .exe, or .dll).

#### Icon Index
*Optional* — Default: `0`

Specifies the icon index within the file. Use 0 for the first icon. Applies to executables, DLLs, or ICOs with multiple icons.

#### Description
*Optional*

Optional text description displayed in the shortcut’s properties. [Not applicable for URL shortcuts.]

#### Working Directory
*Optional*

Specifies the working directory used when launching the shortcut. [Not applicable for URL shortcuts.]

#### Window Style
*Optional* — Default: `Normal`

Specifies the initial window state when the target application starts (Normal, Maximized, Minimized). [Not applicable for URL shortcuts.] Allowed values: `Normal`, `Maximized`, `Minimized`.

#### Run As Administrator
*Optional* — Default: `False`

Indicates whether the shortcut should be configured to run with administrative privileges. [Not applicable for URL shortcuts.]

#### Hot Key
*Optional*

Specifies a keyboard shortcut to launch the shortcut (e.g., CTRL+SHIFT+F). [Not applicable for URL shortcuts.]

## Details

- **Category:** File and directory
- **Brick ID:** `Desktop-CreateShortCut`

## Raw JSON definition

**JSON**

```json
{
  "category": "fileAndDirectory",
  "description": "Creates a shortcut on the desktop for a specified target file or application, with options for customizing the shortcut's name, icon, and arguments.",
  "developerVendor": "CapaSystems A/S",
  "displayName": null,
  "id": "Desktop-CreateShortCut",
  "name": "Create Shortcut",
  "parameters": [
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Specifies the full path of the shortcut to create, including file name and extension (.lnk or .url). Example: C:\\Users\\Public\\Desktop\\MyApp.lnk",
      "id": "LiteralPath",
      "name": "Literal Path",
      "regExValidation": "",
      "required": true,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Specifies the file system path or URL the shortcut will point to.",
      "id": "TargetPath",
      "name": "Target Path",
      "regExValidation": "",
      "required": true,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Optional command-line arguments passed to the target when the shortcut is launched. [Not applicable for URL shortcuts.]",
      "id": "Arguments",
      "name": "Arguments",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Specifies the path to the file containing the icon (e.g., .ico, .exe, or .dll).",
      "id": "IconLocation",
      "name": "Icon Location",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "0",
      "defaultValueObject": null,
      "description": "Specifies the icon index within the file. Use 0 for the first icon. Applies to executables, DLLs, or ICOs with multiple icons.",
      "id": "IconIndex",
      "name": "Icon Index",
      "regExValidation": "",
      "required": false,
      "type": "Integer",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Optional text description displayed in the shortcut’s properties. [Not applicable for URL shortcuts.]",
      "id": "Description",
      "name": "Description",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Specifies the working directory used when launching the shortcut. [Not applicable for URL shortcuts.]",
      "id": "WorkingDirectory",
      "name": "Working Directory",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": null,
      "defaultValueObject": {
        "id": "Normal",
        "name": "Normal"
      },
      "description": "Specifies the initial window state when the target application starts (Normal, Maximized, Minimized). [Not applicable for URL shortcuts.]",
      "id": "WindowStyle",
      "name": "Window Style",
      "regExValidation": "",
      "required": false,
      "type": "ComboBox",
      "value": null,
      "values": [],
      "valuesObject": [
        {
          "id": "Normal",
          "name": "Normal"
        },
        {
          "id": "Maximized",
          "name": "Maximized"
        },
        {
          "id": "Minimized",
          "name": "Minimized"
        }
      ]
    },
    {
      "allowManualInput": false,
      "defaultValue": "False",
      "defaultValueObject": null,
      "description": "Indicates whether the shortcut should be configured to run with administrative privileges. [Not applicable for URL shortcuts.]",
      "id": "RunAsAdmin",
      "name": "Run As Administrator",
      "regExValidation": "",
      "required": false,
      "type": "Boolean",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "allowManualInput": false,
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Specifies a keyboard shortcut to launch the shortcut (e.g., CTRL+SHIFT+F). [Not applicable for URL shortcuts.]",
      "id": "HotKey",
      "name": "Hot Key",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    }
  ],
  "powershell": {
    "base64Encoded": true,
    "function": "ZnVuY3Rpb2..."
  },
  "type": "powerbrick",
  "version": "2026.9.1.1"
}
```