How to run scripts on Mac?

A script is a file containing a set of programming commands used to automate routine Mac management tasks, such as system configurations, app installations, and security updates, without requiring manual Terminal input.

Why Use Custom Scripts for Mac Management?

Executing scripts remotely via an MDM allows IT administrators to perform complex system-level operations across multiple devices simultaneously. This bypasses the need for physical access and enables configurations that are not natively available in standard MDM feature sets.

• Automation: Streamlines time-consuming tasks like software uninstallation or OS updates.
• Root-Level Execution: Scripts deployed via Hexnode run with root privileges, ensuring full administrative control.
• Zero User Intervention: Tasks are executed in the background without interrupting the end-user.

Prerequisites for Executing Mac Scripts

Before deploying scripts, ensure the following requirements are met to avoid execution failure:

Step 1: Creating an Executable Mac Script Locally

Before uploading to the UEM, follow these steps to create a valid executable file:

1. Open Text Edit from Applications and click New Document.
2. Input your script (e.g., a restart script):
   Execute Mac script locally

   #!/bin/sh /sbin/shutdown -r now

   1 2	#!/bin/sh /sbin/shutdown -r now

3. Click Format > Make Plain Text.
4. Save the file (File > Save). Uncheck “If no extension is provided, use ‘.txt’“, while saving the file.
5. Open Terminal to make the file executable:
   • Navigate to the folder:
     Execute Mac script locally

     cd [location_of_script]

     1	cd [location_of_script]

   • Grant execution permissions:
     Execute Mac script locally

     chmod 700 [filename]

     1	chmod 700 [filename]

6. Test locally:
   Execute Mac script locally

   ./[filename]

   1	./[filename]

Step 2: Deploying Custom Scripts via Hexnode UEM

Once the script is verified, use the Hexnode console to push it to managed devices.

1. Navigate to Manage > Devices and select the target Mac.
2. Select Actions > Others > Execute Custom Script.
3. Configure Script Parameters:
   • Choose script file source: Upload a file, select from Content > My Files, or use Hexnode Genie.
   • Binary Path: Auto-fills based on file extension. (Note: If /bin/sh appears for Bash, update it to /bin/bash).
   • Arguments: Enter arguments separated by spaces. Use single quotes for multi-word arguments (e.g., ‘William Alexander’).

   Standard Binary Paths for macOS

   • Bash: /bin/bash
   • Python: /usr/bin/python
   • Zsh: /bin/zsh
   • Ruby: /usr/bin/ruby
   • Perl: /usr/bin/perl

   Supported Argument Wildcards

   Variables like %devicename%, %serialnumber%, and %username% can be used as arguments to pull real-time device data into the script.

4. Click Execute.
5. Monitor status in Action History. Click Show Output to view logs.

Troubleshooting Guides

Frequently Asked Questions (FAQs)

What level of permission do scripts have when run via Hexnode?

All scripts executed through the Execute Custom Script action run at the root level, providing the highest level of system access.

Can special characters be used in the script filename?

No. While uploading, avoid using / : ? < > \ * | “ [ ] @ ! % ^ # in the filename to ensure compatibility with the UEM repository.

How to verify if a script ran successfully?

Navigate to the Action History tab on the Device Summary page. Successful scripts will show a “Completed” status. Click Show Output to see the actual Terminal results.

Does Hexnode host the scripts uploaded?

Yes. Any script uploaded during the action is automatically saved to Content > My Files for future use.