Run and audit Scripted Sequences

This article guides you through the processes of deploying Scripted Sequences to devices and device groups in your environment, and viewing the various audit logs available for monitoring Scripted Sequence runs.

Prerequisites

      Nerdio Manager subscription

The tasks in this procedure apply to the following Nerdio Manager subscription level(s):

       System/environment requirements

You must have followed the steps in Enable Scripted Sequences to configure the Scripted Sequences feature for use in your environment.

For Intune deployment, the Task Worker requires the PowerShell script execution policy to allow unsigned script execution. The script will be publicly signed in a future release.

       Role-based access control (RBAC) and permissions

Running and auditing scripted sequences in Nerdio Manager requires the Admin role.

       Preparatory steps

Follow Create and edit Scripted Sequences to create your sequences and prepare them to run on your target device(s).

Run a scripted sequence

From the Scripted Sequences page in Nerdio Manager, you can run scripted sequences directly on AVD workspaces or host pools, or schedule them to run on Intune-enrolled devices via a Nerdio Task Worker.

To deploy a scripted sequence directly to AVD workspaces or host pools:

1. Navigate to Automation > Scripted Sequences, and select the Scripted Sequences tab to display a table of existing scripted sequences.

2. Optionally, start typing in the Search box to filter the displayed scripted sequences by title and/or description.

3. Locate the scripted sequence you want to run in the table and select the corresponding Actions icon.

4. From the dropdown, select Run now... to open the Run Scripted Sequence dialog.

5. In the Platform dropdown, select AVD.

6. In the Timeout (days) field, enter an integer value representing the number of days after which the instruction to run the scripted sequence will expire if it has not run on a target device (for example, if the device is offline for an extended period of time). The default value is 3 days.

7. Select target device(s) as follows:

   1. Select the target tenant from the Tenant dropdown.

   2. In the Deploy to... section, you can now specify the target devices from any combination of multi-session host pools, personal host pools, and workspaces. For each target type you want to include:

      • Select Add new target...

      • Select Multi-session host pools, Personal host pools, or Workspaces from the target type drop-down.

      • Start typing the name of a host pool or workspace and select it to add it to the list of targets. Repeat for each host pool or workspace you want to add.

        Caution: While the Scripted Sequences feature is in preview, if the total number of in-scope target devices exceeds 100, the scripted sequence will run only on the first 100 devices.

8. To run the scripted sequence on the target host pool(s) and/or workspace(s), enter the text CONFIRM in the box provided, then select OK.

To set a scripted sequence to run on Intune-enrolled devices:

1. Navigate to Automation > Scripted Sequences, and select the Scripted Sequences tab to display a table of existing scripted sequences.

2. Optionally, start typing in the Search box to filter the displayed scripted sequences by title and/or description.

3. Locate the scripted sequence you want to run in the table and select the corresponding Actions icon.

4. From the dropdown, select Run now... to open the Run Scripted Sequence dialog.

5. In the Platform dropdown, select Intune.

6. In the Timeout (days) field, enter an integer value representing the number of days after which the instruction to run the scripted sequence will expire if it has not run on a target device (for example, if the device is offline for an extended period of time). The default value is 3 days.

7. In the Deploy to... section, specify the target devices as follows:

   • To add managed device group(s) to the target list:

     1. Select Device groups from the target types dropdown.

     2. Start typing the name of a device group in the search box and select it to add it to the list of targets. Repeat for each device group you want to add.

   • Select individual managed device(s) to the target list:

     1. Select Devices from the target types dropdown.

     2. Start typing the name of a device in the search box and select it to add it to the list of targets. Repeat for each device you want to add.

     Caution: While the Scripted Sequences feature is in preview, if the total number of target devices selected (between individual devices and device groups) exceeds 100, the scripted sequence will run only on the first 100 selected devices.

8. To run the scripted sequence on the target device(s), enter the text CONFIRM in the box provided, then select OK.

   Note: If Nerdio Manager has previously run a scripted sequence on a given target device, subsequent scripted sequences should typically start running on the target device within 15 minutes of being initiated. The first time a scripted sequence runs on any device, it will take substantially longer (typically over an hour) to start as Nerdio Manager first needs to provision a Nerdio Endpoint Worker on the device to run scripted sequences.

View logs of Scripted Sequence executions and operations

You can view detailed logs both of executions of Scripted Sequences on target devices and of operations within Nerdio Manager related to Scripted Sequences, including creation and editing of sequences, as well as executions. There is also a separate dashboard for monitoring the activity of Task Workers run on Intune-enrolled devices.

To view the Scripted Sequences executions log:

1. Navigate to Automation > Scripted Sequences, and select the Executions tab. A table of all completed sequence runs is displayed, from most recent to oldest.

   Note: The Executions page currently does not automatically update as new sequence executions are completed. Use the Refresh button to display the most up-to-date list of recently-run tasks.

2. To view a detailed breakdown of the steps in the run, select the date from the Last Run column.

   Note: Where applicable, you can expand the entry in the Result column to view logs related to the step.

3. To view a breakdown of the actions undertaken in the run:

   1. Select the Details icon.

   2. Select an individual task in the Actions column to view its details and logs.

   3. Select a host pool or workspace name to view its details in Nerdio Manager, or select a device name to view its details in the Intune portal.

To view logs of operations related to Scripted Sequences undertaken in Nerdio Manager:

1. Navigate to Automation > Scripted Sequences, and select the Tasks tab. A table of all completed tasks is displayed, from most recent to oldest.

   Note: The term Tasks in this screen refers to actions undertaken within the Nerdio Manager UI, and is a standard interface element for log viewing across Nerdio Manager. It does not refer to the Tasks that make up the building blocks of Scripted Sequences.

2. Optionally, use the Search box to begin searching for a specific task, or the Filter menu to filter the displayed tasks by status.

3. To view a breakdown of the steps undertaken to complete the task, select the Details icon.

To view Task Worker analytics:

1. Navigate to Automation > Task Worker Analytics.

2. Select the Task Workers tab to view information related to all currently deployed Task Workers, including their current version and last activity, along with details of the devices to which they're deployed and their associated resources. Select the Details icon to view the IDs of the associated storage accounts and containers.

3. Select the Commands and Deployments tabs to view details of Task Worker runs. You can view the target device's details in the Intune portal by selecting its name, and view the detailed sequence of actions performed by the Task Worker by selecting an item under Jobs. You can also view error messages for failed runs in the Status column.

4. Select the Upgrades tab to view Task Worker upgrade events.

Need help?

Raise a support ticket for this item.