Configure the PowerShell execution command

Use the input variables you created to configure the command that Orchestration executes on the Windows target machine.

Before you begin

Create the input variables you need in the Inputs form before you can advance to the Execution Command stage.

Role required: activity_creator, admin

Note: You can test the Powershell connection between the MID Server and the target computer without having to run the acvitity in a workflow context. For details, see Test Powershell activity template inputs.

Procedure

  1. Drag variables from the list of inputs and drop them into command fields.
    The system formats the variable in the proper syntax for the command.
    Figure 1. PowerShell execution command
    PowerShell execution command
  2. Complete the fields shown in the table.
    Table 1. Powershell command fields
    Field Description
    Input Input variable builder. Create variables to map to available fields.
    Target host Host name or IP address of the target server for this PowerShell activity.
    Script type Type of script to run on the PowerShell host. Available options are:
    • Custom Powershell command
    • MID Server script file
    MID Server script file MID Server script file to run. This field is available when the Script type selected is MID Server script file.
    Command Command that this activity runs on the target host. This field is available when the Script type selected is Custom Powershell command. You can drag and drop input variables from the variable builder into this field to create your command.
    Powershell variables Name-value pairs to pass to the host with Powershell. You can create these variables manually, or drag input variables into the Value field. Encrypted input variables retain their encryption, regardless of the data type settings in this field. If you type in a value and select the Encrypted data type, your value appears in plain text in this field and is only encrypted when it passes to the ECC Queue.
    Use MID service account Forces this activity to authenticate on the target host using the credentials of the MID Server service account only, without trying any other credentials. When this check box is selected, the Credential tag field is not available.
    Credential tag Specific credential tag this activity must use to run Powershell commands on the host. If this field is left blank, the MID Server tries all the available credentials until it finds a valid one, ending with the MID Server service account. If a credential tag is defined, the MID Server tries the credentials for that tag only and does not try the MID Server service account. This field is not available when the Use MID service account check box is selected.
    Required MID Server capabilities MID Server to use for querying Powershell, by capabilities. By default, the system selects a Powershell MID Server.
  3. Click Save.
  4. Click Continue to advance to the Outputs stage.