Activate Process Execution At First User Logon

Configures Windows Active Setup so a script or program is executed once for each user at their first login

Parameters

File path

Required

Specify the destination path of the file that will be executed upon user login. Only supported formats are ‘.exe’, ‘.vbs’, ‘.cmd’, ‘.bat’, ‘.ps1’, ‘.js’. If the path is $Packageroot\File.cmd the file will be copied to C:\ProgramData\CapaSystems\PowerBricks\ActiveSetup$Key, if the path is something else then it will be executed from the specified path

Arguments

Optional

Specify the arguments to be passed to the file upon execution. If no arguments are needed, leave this field empty

Description

Optional

Description for the Active Setup. Users will see “Setting up personalized settings for: $Description” at logon

Active Setup ID

Required — Default: $AppName

The unique identifier for the Active Setup entry. If you need to remove the Active Setup entry later, you will need to use the same ID

Execution Policy

Optional — Default: Unrestricted

Specify the execution policy for the script, if it is a PowerShell script Allowed values: Unrestricted, RemoteSigned, AllSigned, Restricted, Bypass.

Execute For Logged On User

Optional — Default: True

If a user is logged in the file will be executed for that user. For everyone the file will be executed the first time they login

Details

• Category: Installer
• Brick ID: ActiveSetup-Create

Raw JSON definition

• JSON

{
  "category": "installer",
  "description": "Configures Windows Active Setup so a script or program is executed once for each user at their first login",
  "developerVendor": "CapaSystems A/S",
  "displayName": null,
  "id": "ActiveSetup-Create",
  "name": "Activate Process Execution At First User Logon",
  "parameters": [
    {
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Specify the destination path of the file that will be executed upon user login. Only supported formats are '.exe', '.vbs', '.cmd', '.bat', '.ps1', '.js'. If the path is $Packageroot\\File.cmd the file will be copied to C:\\ProgramData\\CapaSystems\\PowerBricks\\ActiveSetup\\$Key\\, if the path is something else then it will be executed from the specified path",
      "id": "StubExePath",
      "name": "File path",
      "regExValidation": "",
      "required": true,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "defaultValue": "",
      "defaultValueObject": null,
      "description": "Specify the arguments to be passed to the file upon execution. If no arguments are needed, leave this field empty",
      "id": "Arguments",
      "name": "Arguments",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "defaultValue": "",
      "defaultValueObject": null,
      "description": " Description for the Active Setup. Users will see \"Setting up personalized settings for: $Description\" at logon",
      "id": "Description",
      "name": "Description",
      "regExValidation": "",
      "required": false,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "defaultValue": "$AppName",
      "defaultValueObject": null,
      "description": "The unique identifier for the Active Setup entry. If you need to remove the Active Setup entry later, you will need to use the same ID",
      "id": "Key",
      "name": "Active Setup ID",
      "regExValidation": "",
      "required": true,
      "type": "TextBox",
      "value": null,
      "values": [],
      "valuesObject": null
    },
    {
      "defaultValue": null,
      "defaultValueObject": {
        "id": "Unrestricted",
        "name": "Unrestricted"
      },
      "description": "Specify the execution policy for the script, if it is a PowerShell script",
      "id": "ExecutionPolicy",
      "name": "Execution Policy",
      "regExValidation": "",
      "required": false,
      "type": "ComboBox",
      "value": null,
      "values": [],
      "valuesObject": [
        {
          "id": "Unrestricted",
          "name": "Unrestricted"
        },
        {
          "id": "RemoteSigned",
          "name": "RemoteSigned"
        },
        {
          "id": "AllSigned",
          "name": "AllSigned"
        },
        {
          "id": "Restricted",
          "name": "Restricted"
        },
        {
          "id": "Bypass",
          "name": "Bypass"
        }
      ]
    },
    {
      "defaultValue": "True",
      "defaultValueObject": null,
      "description": "If a user is logged in the file will be executed for that user. For everyone the file will be executed the first time they login",
      "id": "ExecuteForCurrentUser",
      "name": "Execute For Logged On User",
      "regExValidation": "",
      "required": false,
      "type": "Boolean",
      "value": null,
      "values": [],
      "valuesObject": null
    }
  ],
  "powershell": {
    "base64Encoded": true,
    "function": "ZnVuY3Rpb2..."
  },
  "type": "powerbrick",
  "version": "2026.7.2.1"
}