Scripts

Run automation scripts on your virtual machines directly from the Xelon HQ interface.

How to Access

Navigate to Virtual Datacenter > All Devices, select a device, then open the Scripts tab on the device detail page. This tab requires the allow_manage_virtual_machine_scripts permission and is not available for DRaaS devices.

Overview

The Scripts tab lets you run shell scripts on a virtual machine. You can either select an existing script from your organization's script library or create a new one on the spot. Scripts are executed directly on the target device.

Selecting an Existing Script

To run a script that has already been saved to your library:

  1. Choose the Select Script mode at the top of the tab.
  2. If your account has access to multiple tenants, use the tenant selector to pick the organization whose script library you want to browse.
  3. Select a script from the dropdown list.
  4. Click Run Script to execute it on the device.

Creating a New Script

To write and run a new script:

  1. Choose the New Script mode at the top of the tab.
  2. Enter a Script name.
  3. Select the script type:
    • Linux /bin/bash Script — for Linux-based devices.
    • Windows Powershell Script — for Windows-based devices.
  4. Write or paste the script code into the Script text area.
  5. Choose one of the two save options:
    • Save script to library — saves the script to your organization's library for future reuse without running it immediately.
    • Save script to library and Run — saves the script and immediately executes it on the device.
Automatic Script Type Selection

When you create a new script, the script type is automatically pre-selected based on the device's operating system. Linux devices default to Bash, while Windows devices default to PowerShell. You can override this selection manually if needed.

Script Library

All scripts created through the New Script mode are saved to your organization's script library. Once saved, a script can be selected and run on any compatible device using the Select Script mode. If your account belongs to multiple tenants, each tenant maintains its own separate script library.