Change Mac Desktop Wallpaper With a Custom Command

Some organizations require that all of the company's managed macOS devices have custom wallpaper set as the desktop background. This article contains two procedures for IT Admins to control a user's desktop wallpaper:

• You can create a custom command and use an MDM Custom Configuration Profile and a policy to enforce a specific wallpaper file. Do not use this procedure in conjunction with the Mac Wallpaper Modification Policy.
• Alternatively, you can create a Mac Wallpaper Modification Policy that allows users to change their wallpaper, and then provide the wallpaper file to them.

Prerequisites:

• The device or device group must be enrolled in an Mobile Device Management (MDM) to use this method.

Creating a Custom Command for Wallpaper

Three steps are required to fully control a macOS user’s wallpaper:

1. Create a custom command to provide a wallpaper image to your devices.
2. Create a custom configuration profile to provide a path to the wallpaper image.
3. Create a policy to deliver and enforce the wallpaper.

To create a custom command for wallpaper for macOS:

1. Log in to the JumpCloud Admin Portal: https://console.jumpcloud.com/login.
2. Go to DEVICE MANAGEMENT > Commands.
3. Click (+), then choose Command to create a new command.
4. Under Name, enter a name for the command. For example, Desktop Wallpaper.
5. Under Run As, choose root.
6. Under Type, click Mac.
7. Under Command, enter #!/bin/bash.

8. Under Event, choose Run Manually.
9. (Optional) Under Timeout After and Time to Live Settings, adjust the times to your preference.
10. Click Upload File, then select the wallpaper image.
11. Under File Destination, enter your desired path. For example, /Users/Shared. The default is the /tmp/ directory, which is periodically cleared, so you should change this.
12. Select the Devices or Device Groups tab, then bind the command to the device or group where you want to set the wallpaper.
13. Click save.
    
14. Find the newly created command in the commands list and click Run Now to send the image to the device or group of devices. 

Creating a Custom Configuration Profile

Create a custom configuration profile with a text editor or a configuration profile creator. In the .mobileconfig file below, change the path in line 21 to the path that you set in Step 11 above. For example, you can change <string>/change/your/path/1.jpg<string> to your path: <string>/Users/Shared/Logo.jpg<string>.

Creating a Custom Policy to Enforce a Wallpaper Change

You'll create a custom policy to deliver a .mobileconfig file to enforce the wallpaper change.

1. In the Admin Portal, navigate to DEVICE MANAGEMENT > Policy Management.
2. Under the All tab, click +.
3. Select the Mac tab.
4. On the New Policy panel, select the Mac tab.
5. Select the MDM Custom Configuration Profile policy, then click configure.
6. For Policy Name, enter a name for this policy. For example, Desktop Wallpaper.
7. Under Settings, click upload and select the .mobileconfig file you modified in Creating a Custom Configuration Profile above.
   
8. (Optional) Select the Device Groups tab. Select one or more device groups where you’ll apply this policy. For device groups with multiple OS member types, the policy is applied only to the supported OS.
9. (Optional) Select the Devices tab. Select one or more devices where you’ll apply this policy. 
10. Click save. This sets the desktop wallpaper on the device or device group.

Creating a Wallpaper Modification Policy

This policy gives users the ability to change the desktop wallpaper on their macOS devices. Configuring and applying this policy lets users use the Apple menu > System Settings > Wallpaper and upload a company wallpaper file that you provide.

To create Mac Desktop Wallpaper Modification policy:

1. Log in to the JumpCloud Admin Portal: https://console.jumpcloud.com/login.
2. Go to DEVICE MANAGEMENT > Policy Management.
3. Under the All tab, click ( + ).
4. Select the Mac tab.
5. Locate the Wallpaper Modification policy, then click configure.
6. Under Policy Name, enter a name for the policy. For example, EMEA Wallpaper Modification.
7. Under Settings, select Allow Changing Desktop Wallpaper to let users control their wallpaper through Apple menu > System Settings > Wallpaper. If you don’t select this field, users cannot change their wallpaper on their macOS devices.
   
8. (Optional) Select the Device Groups tab. Select one or more device groups where you’ll apply this policy. For device groups with multiple OS member types, the policy is applied only to the supported OS.
9. (Optional) Select the Devices tab. Select one or more devices where you’ll apply this policy.
10. Click save.