Scripts - SimpleMDM

You may have noticed that things look a little different. SimpleMDM is now part of the family and we are in the process of moving all of the SimpleMDM Knowledge Base articles to their new home. If you notice any links that are broken or if anything does not work as expected, please email and let us know!


SimpleMDM supports the ability to run remote scripts on devices without requiring a third-party agent to be installed to deploy them.

Creating A Script

To create a new script:

  1. Click Scripts in menu on the left side of the screen.
  2. Click "Create Script".
  3. Give the script a meaningful name.
  4. Click "Choose File" and upload your script file, or type/paste your script directly into the text editor field.
  5. Click Save.

Once you have created your script, you will be able to use it to create a job to run on your devices.

A Note On Restarts

If your script contains a reboot, shutdown, or similar command, SimpleMDM won't be able to detect whether or not that script has completed. The script, however, will not be re-run. As a result, there is no risk of a loop.

Creating A Job

To create a job to run a script:

  1. Click Jobs under the Scripts section of the menu.
  2. Click "Create Job".
  3. Click the "Script" dropdown and select the name of a script that you have previously created.
  4. In the "Run On" field, type the names of any assignment group (from the Assignments page), device group, or individual devices that you would like to run the script on.
  5. Once you have selected the devices or groups you want to run the script on, click "Run".

View Job Information

You can view information any jobs that you have run under the Jobs page. Click the ID to view more information. On the Job Details page, you can see information such as:

  • Script name
  • "Created At" timestamp
  • Which user created it
  • How many devices it was run on
  • Job Status (Pending, Success, Error)

Click the Devices tab to view the devices that it was run on. Click the Script tab to view the script itself.

Script Response Messages

SimpleMDM will store the response message output and code that a script generates. To view the output, visit the Job Details screen, navigate to the Devices tab, and select the associated log for a device. The log will include the script output and response code.

Custom Attributes

The Scripts feature supports the use of custom attributes. To allow custom attributes to be processed within a script, check the box labeled "Enable custom attributes" in the script settings.

Still have a question or want to share what you have learned? Visit our Community to get help and collaborate with others.