This article provides a detailed guide for IT administrators on how to perform a mass deployment of the ClickShare Desktop App (PKG) file using Microsoft Intune on macOS systems. Keep in mind that deployment via Microsoft Intune can vary depending on your company's security regulations and policies, so be sure to always check these before proceeding with the deployment.
Steps for mass deployment of the ClickShare Desktop App (PKG) file using Intune
- Download ClickShare Desktop App PKG file
- Preparations
- Add PKG file to Microsoft Intune
- Install company portal on macOS
Step 1: Download ClickShare Desktop App (PKG) file
Click here to download the ClickShare Desktop App (PKG) file on your macOS device.
- Create an MDM push certificate
- Sign in to the Microsoft Intune admin center.
- Go to the Devices > MacOS > macOS enrollment.
- Click Apple MDM Push Certificate.
- Follow the steps outlined in the image below to generate an MDM certificate.
- Create a group for deployment. For how-to instructions, click here.
- Create a profile:
- Go to Devices >macOS >Update Policy for macOS.
- Click Create profile.
- Name the profile.
- Select an option Download and install or Install immediately from the All other Updates (OS, built-in apps) drop-down menu.
- Add the group(s) to this profile.
For additional instructions on creating a profile. click here.
Step 3: Add PKG file to Microsoft Intune
- Go to the Apps section on the Microsoft Intune Admin center.
- In the By Platform section, select macOS and click +Add.
- Click Select app package file and browse to the location that contains the PKG file.
- Select the file, click Open and then click OK.
- Configure App Information for PKG file (fields marked with an asterisk * are mandatory):
- Name: The app name is automatically extracted from the PKG file, but you can adjust it if necessary.
Note: Avoid using spaces in the name, and ensure the version number does not exceed three digits. You can use underscores, for example, ClickShare_4.40.0. - Description: The description is automatically extracted from the PKG file, but you can edit it if needed. Click Edit Description to make changes.
- Publisher: Enter the Publisher name “Barco”.
- Category: Select an appropriate category. (e.g., Collaboration & Social).
- [Optional] Information URL: Enter a valid url to an information page about the app.
- [Optional] Privacy URL: Enter a valid url to an information about the app’s privacy settings.
- [Optional] Developer: Enter the name of the company or individual that developed the app.
- [Optional] Owner: Enter the name of the primary contact person for this app in your company.
- [Optional] Notes: You can add additional notes here.
- [Optional] Logo: Click Select image to open the file location that contains a file that is associated with the app.
- Name: The app name is automatically extracted from the PKG file, but you can adjust it if necessary.
- Click Next to continue.
- Configure Program for PKG file. Enter the Pre-install and Post-install scripts:
- Pre-install script (mandatory): Required for accepting the EULA (End User License Agreement)
#!/bin/bash
defaults write /Library/Preferences/com.barco.clickshare.plist ACCEPT_EULA -string "YES"
- Post-install script: Use it to pass the ClickShare parameters available for the PKG file. You can include multiple parameters in a single script. For a complete list of available ClickShare parameters, refer to the KB 13078.
Here’s an example of a script for passing multiple parameters: to enable "Product Usage Analytics" and to disable "Auto Update".#!/bin/bash
/Applications/ClickShare.app/Contents/MacOS/ClickShare -PRODUCT_USAGE_ANALYTICS=YES -AUTO_UPDATE=NO
- Pre-install script (mandatory): Required for accepting the EULA (End User License Agreement)
- Configure the OS Requirements: macOS Big Sur 11.0 (minimum operating system) or higher.
- Configure the Detections rules:
- Ignore app version: Select Yes to allow the app to automatically update when a new version is available (recommended default). Select No to manage the version through Intune configuration without automatic updates. When passing the AUTO_UPDATE parameter, ensure it is set to "NO".
- App bundle ID (CFBundleIdentifier): Automatically filled this value from the PKG information (e.g., com.barco.clickshare.updater).
- App version (CFBundleShortVersionString): The app version, e.g. 4.38.0.8.
- Configure the Assignments:
- Required: Add the required targets.
- Available for enrolled devices: Add the targets for which you want to make the app available in the Company Portal.
- Uninstall: Add the targets for which you want to uninstall the app.
- Click Next to continue
- Review the settings and click Create.
Step 4: Install the company portal on a macOS device to enroll the app
Go to Enroll your Mac with Intune Company Portal and follow the instructions to download the Company Portal app and Install the profile on your macOS device.
Troubleshooting tips for the ClickShare Desktop App (PKG) file
- If the ClickShare Desktop (PKG) App fails to install or does not start after installation on your macOS device, we recommend collecting logs from the following locations and contacting Barco Support for assistance (how-to, see KB 6024).
Logs locations:- /Library/Logs/Barco/ClickShare App/updater.log
- $Home/Library/Application Support/Barco/ClickShare App/updater.log
Take a look at this detailed guide on gathering Intune logs from a macOS device.
-
If you are unable to use macOS features like screen recording or others after installing the ClickShare Desktop App (PKG) file, it’s probably because the ClickShare Desktop App doesn’t have the required permissions. To fix this, you might need to create and deploy a PPPC profile in Intune for your macOS device to enable these features (how-to, see KB 13348).
Related articles
- Deploying the ClickShare App with Microsoft Intune
- What are the supported parameters available for the ClickShare Desktop App (PKG) file
- Mass deployment of the ClickShare Desktop App (version 4.28 and higher) across your company
- Mass deployment of the ClickShare Desktop App (version 4.27.2 and lower) across your company