Creating a Worklet

Use the Worklet™ option to perform any scriptable action on devices, including disabling a vulnerable process, managing native OS controls, mass rollback of patches, and moving unwanted applications. You can include variables to securely retrieve secrets. You can also configure restart notifications and deferral settings for worklets.

Creating a Worklet

To create a worklet, follow these steps:

1. From the main console, click Manage → Policies.

2. Click Create Policy.

3. Click Worklet → Next.

4. Click the OS for the worklet you are creating.
   Note: The worklet you create should be run on a device of the same OS. 

5. In the Policy Info area, configure the following:

   • In the Policy Name field, enter a name for the worklet. The field is required.

   • In the Notes field, enter any notes, if required.

6. (Optional) Set filters under Device Targeting, as needed. See Device Targeting with Filters for more information.

7. (Optional) Configure Inputs. Use the Inputs section to add environment variables to the worklet code. See Secrets Management for more information.

8. (Optional) Configure Payload. Select a file to deploy with the worklet. Note: The current file size limit is 1 GB.

9. In the Evaluation Code area, enter a script for the worklet you are creating.

   • Refer to How to Use Worklets. For example worklets, browse our Worklet Catalog for Automox verified worklets, or the Community Worklets library.

   • Note: If you switch to a different OS, the code fields are automatically cleared.

10. In the Remediation Code area, enter remediation logic to execute when the evaluation code above returns non-compliance.

11. In the Schedule area, set the patching schedule that will run on the device. The Schedule Preview provides a calendar view of the patching schedule. See Setting a Patching Schedule.

12. After you set the schedule, you can configure Restart Notifications. Refer to Managing End-User Notifications.

13. Associate Groups to associate this policy with the desired group(s). When the policy is saved, the group is then assigned to the policy.

14. Click Create Policy.

Disabling a Worklet

To disable a worklet, follow these steps:

1. From the Policy page, click the worklet you want to disable.

2. From the Edit Worklet page, go to Groups and remove any associated groups.

3. Click Save Policy.

Browse the Worklet Catalog

The catalog of worklets allows you to immediately use a verified worklet for your purposes. You can also create a new policy based on an existing worklet. Refer to Worklet Catalog for details.

Contact Automox Support (Submit a request) for further assistance.

Related Topics:

• Device Targeting with Filters

• Using Secrets in a Worklet Policy

• Setting a Patching Schedule

• How to Use Worklets

• See our Community discussions around worklets.

• See Enabling and Using Ask Otto by Automox for details about using our script assistant