To run a script on an agent or agents, you will need to either create, upload, generate (using AI), or duplicate a script from the Shared Script Library (accepted formats include MSI, Bash files, CMD files, and Powershell). For more information, see:
Run script on a single agent
via the Devices page
1. From the Devices page, click Manage Run script on the device.
The Run script window appears.
3. Click Run on the chosen script.
Note: You can run scripts from the My scripts tab (scripts you've created, uploaded, or cloned from the Shared Script Library) or the Shared Script Library tab (Atera and community-submitted scripts).
The Script execution summary window appears.
Note:
- If a script exceeds a runtime of two minutes, the Script execution summary window will display the message: "Unable to reach agent... see the Recent Processes report for updates".
- An exit code of 0 means the script executed successfully without any errors. If the exit code is 1, it means a general error has occurred, often due to incorrect usage or a minor problem within the script.
You can view the script execution summary anytime in the Agent console's Activity log
via the Agent console
1. From the Devices page, select the device.
The Agent console appears.
2. Click Manage > Run script.
The Run script window appears.
3. Click Run on the chosen script.
Note: You can run scripts from the My scripts tab (scripts you've created, uploaded, or cloned from the Shared Script Library) or the Shared Script Library tab (Atera and community-submitted scripts).
The Script execution summary window appears.
Note:
- If a script exceeds a runtime of two minutes, the Script execution summary window will display the message: "Unable to reach agent... see the Recent Processes report for updates".
- An exit code of 0 means the script executed successfully without any errors. If the exit code is 1, it means a general error has occurred, often due to incorrect usage or a minor problem within the script.
You can view the script execution summary anytime in the Agent console's Activity log
via the Site page
1. From the Sites page, select the site.
The Site page appears.
2. From the Devices tab, click Manage Run script on the device.
Via the Customer page
1. From the Customers page, select the customer.
The Customer page appears.
2. From the Devices tab, click Manage > Run script on the device.
The Run script window appears.
3. Click Run on the chosen script.
Note: You can run scripts from the My scripts tab (scripts you've created, uploaded, or cloned from the Shared Script Library) or the Shared Script Library tab (Atera and community-submitted scripts).
The Script execution summary window appears.
Note:
- If a script exceeds a runtime of two minutes, the Script execution summary window will display the message: "Unable to reach agent... see the Recent Processes report for updates".
- An exit code of 0 means the script executed successfully without any errors. If the exit code is 1, it means a general error has occurred, often due to incorrect usage or a minor problem within the script.
You can view the script execution summary anytime in the Agent console's Activity log
Run script on multiple agents
via the Devices page
1. From the Devices page, select the devices. Then click Run script.
The Run script on devices window appears.
2. Select your script execution preference (you can set the queue duration for offline devices; 1 hour, 1 day, 1 week, 2 weeks, or 1 month).
3. Click Run on the chosen script.
A snackbar confirming the script execution has started appears.
To see the results for all devices, check out the Recent Processes report
For a specific device, you can view the script execution summary in the Agent console's Activity log
via the Site page
1. From the Sites page, select the site.
The Site page appears.
2. From the Devices tab, select the devices. Then click Run script.
via the Customer page
1. From the Customers page, select the customer.
The Customer page appears.
2. From the Devices tab, select the devices. Then click Run script.
The Run script on devices window appears.
2. Select your script execution preference (you can set the queue duration for offline devices; 1 hour, 1 day, 1 week, 2 weeks, or 1 month).
3. Click Run on the chosen script.
A snackbar confirming the script execution has started appears.
To see the results for all devices, check out the Recent Processes report
For a specific device, you can view the script execution summary in the Agent console's Activity log