Mobile Device Management
Citrix Workspace app now supports Mobile Device Management (MDM) that allows the administrators to configure, secure, and support Citrix Workspace app for Mac by enforcing policies through any MDM tool.
Install and uninstall Citrix Workspace app through the MDM
You can use terminal commands to install and uninstall the Citrix Workspace app through the MDM. For more information about using the terminal commands to install and uninstall, see the Manual install and Uninstall section.
To install Citrix Workspace app for Mac:
- Download the
.dmg
file for the version of Citrix Workspace app for Mac that you want to install from the Downloads page. - Open the downloaded
CitrixWorkspaceApp.dmg
file. - Drag the
Install Citrix Workspace.pkg
file into the folder. -
Use the following terminal command to install the package through MDM:
sudo installer -pkg /Volumes/Citrix\ Workspace/Install\ Citrix\ Workspace.pkg -target / <!--NeedCopy-->
To uninstall Citrix Workspace app:
You can use the following terminal command to uninstall the Citrix Workspace app through MDM:
sudo /Library/Application\ Support/Citrix\ Receiver/Uninstall\ Citrix\ Workspace.app/Contents/MacOS/Uninstall\ Citrix\ Workspace --nogui
<!--NeedCopy-->
Settings supported on MDM
Setting | Description | Key | Value | Value type | Default Value | Supported version |
---|---|---|---|---|---|---|
Set pre-populated username | Sets the username that will be pre-populated in the authentication prompt. | CitrixUserName | UserNameValue | String | NA | 2411 |
Lock pre-populated username | Locks the pre-populated username field, used with CitrixUserName to prevent edits. | LockUserName | UserNameValue | Boolean | NA | 2411 |
Auto update - AutoUpdateScheduler | Allows administrators to manage the Select the update channel option, preventing end users from modifying it. | AutoUpdateSchedulerSettings | {"startTime":"20:30","endTime":"23:30","deferCount":"4"} |
String | NA | 2411 |
Version Control | Allows administrators to manage version control and auto-updates for Citrix Workspace plugins. | AutoUpdatePluginsSettings | {"pluginName": "Citrix Workspace", "pluginId": "D99C3E77-FBF5-4B97-8EDA-4E381A1E0826", "pluginSettings": {"deploymentMode": "InstallAndUpdate", "upgradeToLatest": false, "minimumAllowedVersion": "24.02.10.24", "maximumAllowedVersion": "24.02.10.24", "delayGroup": "Medium"}} |
String | NA | 2411 |
Auto update - Zoom AutoUpdatePluginsSettings | Settings for managing auto-updates of plugins in Citrix Workspace. | AutoUpdatePluginsSettings | [{ "pluginName": "Zoom VDI AutoUpgrade Plugin", "pluginId": "1A4BB471-022C-4C87-BDCD-0B64FB42869C", "pluginSettings": { "deploymentMode": "InstallAndUpdate", "upgradeToLatest": true, "ftu": true } }] |
String | NA | 2411 |
Auto update - AutoUpdateChannel | Allows administrators to manage the Select the update channel option, preventing end users from modifying it. | AutoUpdateChannel | release/beta | String | release | 2409 |
Enable/disable to install Citrix Enterprise Browser during Citrix Workspace app installation | Allows administrators to enable or disable the installation of Citrix Enterprise Browser during Citrix Workspace app installation. | RemoveCitrixEnterpriseBrowser | true/false | Boolean | False | 2405 |
Enable/disable loss tolerant mode for audio redirection | Allows administrators to enable or disable the loss-tolerant mode (EDT lossy) for audio redirection. | EdtUnreliableAllowed | true/false | Boolean | True | 2402 |
Enable/disable audio volume synchronization | Allows administrators to enable or disable the synchronization of audio volume between the VDA and your audio devices. | EnableVolumeSync | true/false | Boolean | True | 2402 |
Enable/Disable H.265 video decoding | Allows administrators to enable or disable the H.265 video codec (HEVC) for hardware acceleration of remote graphics and videos. | EnableXdecoderForH265 | true/false | Boolean | True | 2402 |
Select browser for FIDO2 web Authentication | Allows administrators to select the type of browser used for authenticating an end user into Citrix Workspace app. For more information about the description of values, see FIDO2 based authentication when connecting to cloud and on-premises store | WebBrowserForAuthentication | System/SystemWithPrivateSession/Embedded/EmbeddedWithPrivateSession | String | EmbeddedWithPrivateSession | 2307 |
Enable/disable FIDO2 authentication for HDX session | Allows administrators to enable or disable FIDO2 authentication within an HDX session. | Fido2Enabled | true/false | Boolean | true | 2307 |
Quick access menu for StoreFront | Allows administrators to enable or disable the Quick access menu for On-prem stores. | ShowQuickAccessForStoreFront | true/false | Boolean | false | 2307 |
Auto update – AutoUpdateState | Updates Citrix Workspace app to the latest version without any user intervention automatically. | AutoUpdateState | Auto/Manual/Disabled | String | Auto | 2305 |
Enable Azure Active Directory | Allows administrators to configure and enforce Azure Active Directory conditional access policies for users authenticating to Citrix Workspace app. | enableAAD | true/false | Boolean | False | 2305 |
Auto start of Citrix Workspace app | Controls Citrix Workspace app for Mac to start automatically whenever a computer is turned on by an end user. | AutoLaunchAppOnRestart | true/false | Boolean | True | 2304 |
Pre-configuration of Store URL | Allows administrators to preconfigure and add the store details to the Workspace app so that the end users don’t have to do it. | StoreURLs | <Store URL> |
String | NA | 2210 |
Block new Store addition by end-user | Prevents the end user from adding a store in the Workspace app on their endpoint devices. | BlockStoreAddition | true/false | Boolean | False | 2210 |
Show/Hide menu bar | Shows or hides the Citrix Workspace menu on the Mac menu bar. | ShowHelperInMenuBar | true/false | Boolean | True | 2208.1 |
Schema for reference
<array>
<dict>
<key>ShowHelperInMenuBar</key>
<true/>
<key>AutoLaunchAppOnRestart</key>
<true/>
<key>StoreURLs</key>
<array>
<string>PROVIDE STORE URL HERE</string>
</array>
<key>BlockStoreAddition</key>
<false/>
<key>CEIPEnabled</key>
<true/>
<key>AutoUpdateState</key>
<string>Auto</string>
<key>AutoUpdateChannel</key>
<string>release</string>
<key>WebBrowserForAuthentication</key>
<string>Embedded</string>
<key>Fido2Enabled</key>
<false/>
<key>ShowQuickAccessForStoreFront</key>
<true/>
<key>EnableXdecoderForH265</key>
<false/>
<key>EnableVolumeSync</key>
<false/>
<key>EdtUnreliableAllowed</key>
<false/>
<key>PayloadDisplayName</key>
<string>Citrix Workspace</string>
<key>PayloadIdentifier</key>
<string>com.citrix.receiver.nomas</string>
<key>PayloadType</key>
<string>com.citrix.receiver.nomas</string>
<key>PayloadUUID</key>
<string>3BE38AD3-7D95-423F-BD7B-8A4D1F5208EF</string>
<key>PayloadVersion</key>
<integer>1</integer>
</dict>
</array>
<!--NeedCopy-->