Hello Everyone; today we will learn about Citrix Receiver Workspace App Deployment using SCCM using the Application Model. In this guide, we will make use of the EXE application. We will show you a detailed step-by-step guide for Citrix Deployment using the Application Model.
Citrix Workspace App is the one that provides access to VDI infrastructure or Virtual Desktops or Virtual Apps. Citrix Virtual Apps and Desktops are used to publish VMs from a hypervisor to remote clients. Every user gets a unique OS and desktop by publishing a virtual machine.
Citrix didn’t have any MSI installer for the Citrix Workspace app. The only available installer is an EXE. However, SCCM or Intune can help you to deploy this app on a scale. Citrix also provides ADMX and ADML to deploy the Citrix Workspace App. Logon script and GPO are other options to install and upgrade the Workspace app.
You can download the Citrix Receiver Workspace App from Citrix. One must download the offline windows setup for 64bit architecture from the Citrix website. You must use this EXE application guide using SCCM for all the other deployments.
Pre-requisites – Deploy EXE Application using SCCM
We have not seen any Citrix MSI Application, so we need to use EXE Application to deploy and install the Citrix Workspace Application. Now, before we proceed further, we must have these three things in advance, especially when we have a .exe setup:
- Installation Command/Uninstallation Command
- Detection Method
- Application Icon
With the help of the internet, one can find an Install command for any application. In our case, we have to search the install command for the Citrix Workspace Application. After searching, the install command for the Citrix workspace Application is CitrixWorkspaceApp.exe /silent.
After you successfully installed Citrix using the install command in your test environment. Now you have to try the Uninstall command. Here Unistall command is CitrixWorkspaceApp /uninstall /silent.
For Detection logic, we are using the File System setting type here. In File System, we will choose and pick any file from the folder where Citrix gets installed in the directory. Here the path is:
- %ProgramFiles(x86)%\Citrix\ICA Client\Receiver
- Select the Receiver.exe file from this path and check the version details.
- Create SCCM Application Deployment using PowerShell
- Create Script Deployment Type using PowerShell for SCCM EXE Application
Create Citrix Workspace Application using SCCM Console
In this EXE application deployment guide, we will use the SCCM admin console to create applications. However, there are PowerShell methods also available to create and deploy applications. You can refer to the following guide to get more details.
To start with the Application creation part, copy the downloaded Citrix Workspace App .exe setup to the package source location of the SCCM Server.
- Navigate to SCCM Console \Software Library\Overview\Application Management\Applications.
- Right-click on Applications and select Create Application.
For all EXE application deployment, always Select the Manually Specify the Application Information option and click Next.
In the General Information Tab, you need to provide the metadata information of the SCCM Citrix Workspace application. You need to enter the details like :
- Name, Publisher, and Software Version.
- And Click on Next.
Then in the Software Center Tab, Enter the Application Name and upload the Icon by clicking on Browse. Then Click on Next as highlighted in the image.
The Deployment tab is the place where you need to specify the Citrix Workspace App installation command lines and detection methods, etc. This is a mandatory step for all SCCM EXE Application Deployments.
- In the Deployment Types Tab, Click on Add.
Now the Deployment Type Wizard will pop up, and in General Tab, select Manually Specify the Deployment type information and click on Next.
Citrix Receiver Workspace App Install or Uninstall Command Lines
After this, the General Information Tab appears, in which you just have to enter the application’s name and click on Next. Now in Content Tab, enter the important details mentioned below and click Next.
- Content-Location (Browse for the UNC path where your setup is kept)
- Installation Program
- CitrixWorkspaceApp /silent
- Uninstall Program
- CitrixWorkspaceApp /uninstall /silent
|Install Command Line for Citrix||Uninstall Command Line for Citrix|
|CitrixWorkspaceApp.exe /silent||CitrixWorkspaceApp.exe /uninstall /silent|
Detection Method for Citrix Workspace App
Now in the Detection Method Tab, click on Add Clause, and a new Detection Rule page will pop up. Fill all the details very carefully as mentioned below:
- Select File System in the Setting Type.
- Select File in the Type box.
- Copy the path in the Path box
- %ProgramFiles(x86)%\Citrix\ICA Client\Receiver
- Look for the file called “Receiver.exe“
- Check for the Product version = 126.96.36.199
- Enter Receiver in the File or folder name.
The following table provides clearer options for a detection method for an exe (CitrixWorkspaceApp .EXE) file. The Receiver.exe file version is important to get the SCCM supersedence working.
|Setting Type||Path/Hive||File Name/Key||Property||Operator||Value|
|File System||%ProgramFiles(x86)%\Citrix\ICA Client\Receive||Receiver.exe||Version||Greater than||188.8.131.52|
Now in the User Experience Tab, specify Install for the system in Installation behavior; in the Logon requirement, choose Whether or not a user is logged on and Set Installation Program Visibility to Normal. Also, provide the Maximum allowed run time and Estimated installation time as shown below and click on Next.
Click on Next in the Requirement, Dependencies, and Summary Tab. After this, in the end, Click on Close in the Completion Tab as shown below.
Then back in the Create Application Wizard, click Next in Deployment Tab.
After this, click Next on the Summary Tab and end this Create Application Wizard by clicking on Close in Completion Tab.
Distribute Citrix Workspace Application to the SCCM DP
After creating the SCCM Application for Citrix Receiver (Workspace App), it will appear in the Application Node. To begin with, the distribution right-clicks on the Citrix Workspace Application and clicks on Distribute Content, as shown in the picture below.
The Distribute Content Wizard will open, and click Next in the General Tab. Then select the Application Name in the Content Tab and Click on Next.
- After this, in the Content Destination Tab, Click on Add and select the Distribution Point option.
Then Add Distribution Point page will pop up, and choose the Distribution Point on which you want to distribute the Application.
After this, Click Next on Summary Tab and complete this Distribution process by clicking Close on Completion Tab.
Deployment of Citrix Workspace App using SCCM
So far, we have accomplished two tasks, i.e., Application Creation and Application Distribution to the DP. Now all that is left is the Deployment of the Citrix Workspace Application on the All Windows 10 Device Collection.
- As you can see, your Application is displaying in Application Node, Right-click on Citrix Workspace Application and select Deploy.
After this, Deploy Software Wizard opens, and in the General Tab, enter the Name of the Application and click on Browse to select the Collection.
- Now the Select Collection page will pop up; and choose Device Collection from the drop-down menu, and then
- Select your targeted Device Collection and click on OK, and then Next.
- Here I choose All Windows 11 Devices.
Now in the Content Tab, select the Distribution Point on which the Application is distributed and click on Next.
Now in the Deployment Settings Tab, select:
- Install in the Action box
- And choose Available in the Purpose category.
In the Scheduling Tab, enter the time details if you want it to be available at a specific time; otherwise, leave it as it is and click Next. After this, in the User Experience Tab,
- Select Display in Software Center and shows all notification options in the User notifications, and click on Next as shown below.
In the Alerts and Summary Tab, click on Next and to end the process, click on Close in the Completion Tab.
Windows 11 Client Machine
In this section, we will check the end-user experience for Citrix Workspace Application Deployment and Installation. The Citrix Application is Created, Distributed, and Deployed.
Now, if you check the Software Center of Win 11 device from the ALL Windows 11 Device Collection, you will see the application there in Available Mode, and the user can install it as per the requirement.
As you can see in the below screenshot, the Citrix application is installed successfully on Windows 10/11 devices. This proves that the above silent install and uninstall command and detection logic works fine for Citrix Workspace Application Installation using SCCM.
So here we have finally created, Distributed, and Deployed the Citrix Workspace Application as it is available in the Software Center as shown in the above image.
Error 0X87D00324 with Citrix Receiver Workspace App Installation
Citrix Receiver app or Workspace app needs a restart to complete the installation; hence there could be chances that you might get the following retry error 0x87D00324(-2016410844) in the Software Center application.
Also, in the SCCM Admin console – You will get the following \Assets and Compliance\Overview\Devices\”Error-0X87D00324” status devices from deploying “Citrix Workspace App” to “All Windows 11 Devices” error.
NOTE! – Error-0X87D00324 – The application was not detected after the installation was completed. Source: System Center Configuration Manager
The detection method failed because the status is returned as Failed in this scenario. You can check AppDiscovery.log (SCCM Logs for applications). More details on SCCM app troubleshooting – Deep Dive SCCM Application Model Troubleshooting – Client End.
Did not detect app deployment type Citrix Workspace App(ScopeId_1074285A-82C7-474F-B242-1EE20F8C3CE5/DeploymentType_64cf036a-89a0-4899-b9e5-2e8d29d16b0a, revision 2
AppEnforce.log gives you more details on exit code 4008. You can configure a custom exit code (4008) that shows the Citrix Workspace app. An unmatched exit code (40008) is considered an execution failure error message is a bit confusing if you check the meaning of the exit code meaning of 4008.
- 40008 means, “This version of Citrix Workspace app has already been installed. Nothing to do.”
Process 4316 terminated with exitcode: 40008 Looking for exit code 40008 in exit codes table... Unmatched exit code (40008) is considered an execution failure.
The solution is to restart the Windows 11 PC and, after the restart, the correct status of the Citrix Receiver or Workspace application installation. Or you must use a custom exit/return code (4008) for successful deployment for the SCCM Citrix receiver or Workspace App.
I have restarted the Windows 11 devices, and I have also added the custom return or exit code for Citrix Receiver or Workspace app, as explained above. This helped to resolve or fix the Citrix Workspace app deployment errors using SCCM. Following are the detection logic details from AppDiscovery.log.
Performing detection of app deployment type Citrix Workspace App(ScopeId_1074285A-82C7-474F-B242-1EE20F8C3CE5/DeploymentType_64cf036a-89a0-4899-b9e5-2e8d29d16b0a, revision 3 Detected app deployment type Citrix Workspace App(ScopeId_1074285A-82C7-474F-B242-1EE20F8C3CE5/DeploymentType_64cf036a-89a0-4899-b9e5-2e8d29d16b0a, revision 3) for system
There are some additional tips from the Twitter community on Citrix Workspace Application. The @VisloDK user suggested that “Edge webview should be added as a dependency otherwise it will fail in TS or if components are missing on the machine.”
Abhinav Rana is working as an SCCM Admin. He loves to help the community by sharing his knowledge. He is a BTech graduate in Information Technology.