Script Hosts provide rules-based definitions for using hosts to run scripts without needing to provision VM resources specifically to execute the scripts. For example, running a shell script to make a web service call, or a PowerShell script which registers Active Directory objects.

Using Script Hosts, administrators can ensure that their scripts are executed from a defined set of hosts which are securely protected and hardened.

There are two types of Script Hosts which can be defined:

• Linux Scripts Hosts
• Windows Script Hosts

This article describes the steps required to manage Script Hosts.

Please refer to the article Node Definition - Script Hosts for information about using Script Hosts as part of a blueprint design.

Prerequisites

• Administrative access to the Automation UI
• For Linux Script Hosts, a deployed Linux host which can be accessed via SSH
• For Windows Script Hosts, a deployed Windows host which can be accessed via WinRM or SSH
• Access credentials to the host which has permissions to execute scripts

Creating a Script Host

This section describes the steps required to create a new Credential.

The steps are provided are for a Windows Script Host, but are generally identical for a Linux Script Host.

1. Log into the Broker UI as an administrative user
2. Navigate to Admin > Control Panel
   
   
3. Select the Windows Script Hosts or Linux Script Hosts tile
   
4. A list of existing Script Hosts is displayed
   
5. Click Add
6. On the Add Windows Script Host screen, provide a name for the host
7. On the Add Windows Script Host - Scope Rule screen, provide the following information:
   • Environment: The environment when this host will be used
   • Account/Network: The cloud account or specific network when this host will be used
     
8. On the Add Windows Script Host - Definition screen, provide the following information:
   • OS Version: The Operating System version of the defined host
     Note: This is generated from the configured Operating Systems which match the operating system type of the Script Host being defined (Windows or Linux)
   • Host/IP: The hostname, FQDN, or IP of the defined host
   • Authentication Mode: How the Broker appliance will authenticate to the defined host
   • Access Protocol: How the Broker appliance will connect to the defined host
     
9. Click Add
10. The Script Host has been added
    
11. Additional hosts can defined and ordered - if multiple hosts are defined, they are evaluated and matched in a top-to-bottom order

Removing a Script Host

This section describes the steps required to remove a Script Host.

1. Log into the Broker UI as an administrative user
2. Navigate to Admin > Control Panel
   
   
3. Select the Windows Script Hosts or Linux Script Hosts tile
   
4. A list of existing Script Hosts is displayed
   
5. On the Script Host to be removed, select the Edit drop down list
   Click Remove
   
6. Click Remove
   
7. The Script Host has been removed