Scripts

NAVIGATION  Modules > Automation > Scripts

SECURITY  Automation > View Tasks & Scripts

SECURITY  Automation > Edit Tasks & Scripts

In addition to the plethora of device management and analysis tools included with VSA 10 by default, the Scripts page enables you to create your own scripts to deploy to endpoints as automation tasks.

This article describes the process to view and manage your scripts.

NOTE  To learn how to create and deploy scripts and tasks to managed devices, refer to Tasks.

Overview

  1. To access the Scripts page, in the left navigation menu of your VSA 10 instance, click Automation > Scripts.

  2. The page will load. You'll see a list of all scripts created by all users in your environment. The VSAX Starter Pack is included with your instance by default.

  1. As you navigate, you'll see the following features and fields:

Scripts content packs

VSA 10 is provisioned with a set of standard script content to be used as feature enhancements, templates, and best practices for automating IT operations and device management. The content is frequently updated by a dedicated team based on industry standards and customer feedback.

  • Built-in and VSAX Starter Pack: Sets of scripts for general automation and troubleshooting.
  • Extended Audit For Computers and Extended Audit For Servers: Sets of scripts extending the audit capabilities for Windows servers and computers. The scripts are write protected and executed automatically in product on Windows servers and Windows 10/11 computers. The extended audit information is available as custom files to be used in daily operations, troubleshooting, and compliance investigations.

Folders list

Hover over any item in the list to access its management options.

Feature Definition
Folders

Lists all script collections for your VSA platform, sorted alphabetically; click any folder in the Folders list to view a list of the scripts it contains.

The folders Built-in, Extended Audit For Computers, and Extended Audit For Servers contain several included scripts that you can use as examples, copy, and edit for your own uses.

Find a Script

Enter a partial or whole value to filter current view to matching records.
New folder

Click to create a new script folder.

Edit the folder's name.

Delete the folder.

Scripts pane

Hover over any item in the list to access its management options.

Feature Definition
New Script

Click to begin the script creation workflow; refer to Creating and editing scripts to learn more.

Moves the script.

Begins the script editing workflow; refer to Creating and editing scripts to learn more.

Duplicates the script.

Deletes the script.

Click any header to sort the displayed records in ascending or descending order by the column's value.

Field Definition
Name

Name of the script.
Platform

Platform(s) to which the script applies.
Author

Name of the last user to edit the script.

From the Scripts page, click New Script or click the name of an existing script to open the editor. Populate or change the following fields, and then click Save.

Page section Field or feature name Definition
Details Name

The script's name.
Description

A brief description of the script's purpose.
Inputs + New

Click to create a variable based on a text, number, boolean, date, or VSA 10 field value to use as a variable in your scripts; when adding a variable, provide the following details and click Save Variable:

Name The variable's name; this value must be alphanumeric and will be used by the script
Use custom field value Enable to use the value of an existing VSA 10 field as the variable's payload
Custom Field If Use custom field value is selected, the VSA 10 field from which the variable will define its value; subsequent fields will be unavailable
Variable Type Variable payload type; possible options are Text, Number, Boolean, or Date
Default Value Value contained in the variable payload
Outputs + New

Click to create a variable that can capture script elements for use in other places within VSA 10, including instructing the platform to write the values to associated custom fields; when adding a variable, provide the following details and click Save Variable:

Name The variable's name; this value must be alphanumeric and will be used by the script
Variable Type Variable payload type; possible options are Text, Number, Boolean, or Date
Default Value Value contained in the variable payload
Set custom field value Enable to use the value of an existing VSA 10 field as the variable's payload
Custom Field If Set custom field value is selected, the VSA 10 field from which the variable will define its value; subsequent fields will be unavailable
Windows, Linux, macOS Enable

When enabled, the script will execute on the selected operating system.
Script type

Instructs the endpoint to use Bash, PowerShell, or VBScript protocol when executing the script.
Code editor

Free-text field enabling customization of the script payload for each selected operating system.
Insert Output Variable Code

Paste code at the cursor's location from variables defined in the Outputs section of the page.