Skip to main content

HelloID

Add, edit, or remove a PowerShell target system
Add a PowerShell target system

  1. Recommended: Check the Provisioning GitHub resources to see if a GitHub repository already exists with a connector template for your target system. Templates exist for Google Workspace, the Microsoft Graph API (advanced Azure AD), Blackboard, TOPdesk, and many more.

  2. Go to Target Systems.

  3. Click Add System.

    2021-10-06_14-45-18.png

  4. On the Create System dialog box, select PowerShell Target and click Create.

    2022-04-06_10-49-22.png

  5. Optional: If you're using a connector template from GitHub, then copy and paste the contents of the following files to prepare the target system for configuration:

    Tip

    Some repositories only contain (and require) a subset of these files, or may also contain additional files, in which case they are described in the repository's readme.

    configuration.json

    Account tab > Custom Connector Configuration > Edit (Configure an input form (PowerShell v1/v2 target systems))

    2022-12-01_12-18-23.jpg

    create.ps1, delete,ps1, disable.ps1, enable.ps1, update.ps1

    Account tab > Configure buttons (Customize an account script)

    2022-12-01_12-19-21.jpg

    entitlements.ps1

    Permissions tab > Add Permission Set > enable Use Script To Retrieve Permissions > Retrieve Permissions Script (Retrieve permissions script)

    2022-12-01_12-20-34.jpg

    grantPermission.ps1

    Permissions tab > Add Permission Set > enable Use Separate Script For Each Action > Grant Action Script (Grant permission script)

    2022-12-01_12-21-30.jpg

    revokePermission.ps1

    Permissions tab > Add Permission Set > enable Use Separate Script For Each Action > Revoke Action Script (Revoke permission script)

    2022-12-01_12-22-12.jpg

  6. Continue setting up the target system by following the steps in Configure a PowerShell target system.

Warning

By default, all new target systems are disabled, and all thresholds are enabled.

Edit a target system

  1. Go to Target Systems.

  2. Click Edit for the relevant system.

  3. Continue by following the steps for the relevant type of target system:

Remove a target system

  1. Go to Target Systems.

  2. For the relevant system, Edit a target system.

  3. Click Delete.

  4. On the Confirm System Deletion dialog box, click Delete to confirm.

The system is removed, including all its Entitlements that are configured in Business rules. Entitlements that are currently granted become unmanaged (see Unmanage).

In this section: