Deploy

You can deploy the Citrix Workspace app in the following methods:

Using Active Directory and sample scripts

You can use Active Directory Group Policy scripts to deploy Citrix Workspace app based on your organizational structure. Citrix recommends using the scripts rather than extracting the .msi files. For general information about startup scripts, see the Microsoft documentation.

To use the scripts with Active Directory:

  1. Create the Organizational Unit (OU) for each script.
  2. Create a Group Policy Object (GPO) for the newly created OU.

Edit scripts

Edit the scripts with the following parameters in the header section of each file:

  • Current Version of package - The specified version number is validated and if it isn’t presented, the deployment proceeds. For example, set DesiredVersion= 3.3.0.XXXX to exactly match the version specified. If you specify a partial version, for example, 3.3.0, it matches any version with that prefix (3.3.0.1111, 3.3.0.7777, and so on).
  • Package Location/Deployment directory - This specifies the network share containing the Citrix Workspace app installer packages and is not authenticated by the script. The shared folder must have Read permission set to EVERYONE.
  • Script Logging Directory - The network share where the install logs are copied and the ones that script didn’t authenticate. The shared folder must have Read and Write permissions for EVERYONE.
  • Package Installer Command Line Options- These command-line options are passed to the installer. For the command-line syntax, see Using command-line parameters.

Scripts

Citrix Workspace app installer includes the sample of both per-computer and per-user scripts to install and uninstall Citrix Workspace app. The scripts are present in the Citrix Workspace app for Windows Downloads page.

Deployment type To deploy To remove
Per-computer CheckAndDeployWorkspacePerMachineStartupScript.bat CheckAndRemoveWorkspacePerMachineStartupScript.bat
Per-user CheckAndDeployWorkspacePerUserLogonScript.bat CheckAndRemoveWorkspacePerUserLogonScript.bat

To add the startup scripts:

  1. Open the Group Policy Management Console.
  2. Select Computer Configuration or User Configuration > Policies > Windows Settings > Scripts.
  3. In the right-hand pane of the Group Policy Management Console, select Logon.
  4. Select Show Files, copy the appropriate script to the folder displayed, and close the dialog.
  5. In the Properties menu, click Add and Browse to find and add the newly created script.

To deploy Citrix Workspace app for Windows:

  1. Move the user devices assigned to receive this deployment to the OU that you created.
  2. Reboot the user device and log on.
  3. Verify that the newly installed package is listed in the Program and Features.

To remove Citrix Workspace app for Windows:

  1. Move the user devices chosen for removal to the OU you created.
  2. Reboot the user device and log on.
  3. Verify that the newly installed package isn’t listed in the Program and Features.

Using workspace for web

The workspace for a web enables you to access StoreFront stores through a browser using a webpage.

Before connecting to an app from a browser, do the following:

  1. Install the Citrix Workspace app for Windows.
  2. Deploy the Citrix Workspace app from workspace for web

If workspace for web detects that a compatible version of Citrix Workspace app isn’t present, a prompt appears. The prompt shows that you must download and install Citrix Workspace app for Windows.

Note:

The workspace for the web does not support email-based account discovery.

Use the following configuration to prompt for the server address only.

  1. Download CitrixWorkspaceApp.exe to your local computer.
  2. Rename CitrixWorkspaceApp.exeto CitrixWorkspaceAppWeb.exe.
  3. Deploy the renamed executable using your regular deployment method. If you use StoreFront, see Configure StoreFront using the configuration files in the StoreFront documentation.

Using System Center Configuration Manager 2012 R2

You can use Microsoft System Center Configuration Manager (SCCM) to deploy Citrix Workspace app.

You can deploy the Citrix Workspace app using the SCCM using the following four parts:

  1. Adding Citrix Workspace app to the SCCM deployment
  2. Adding distribution points
  3. Deploying the Citrix Workspace app to the software center
  4. Creating Device Collections

Adding Citrix Workspace app to the SCCM deployment

  1. Copy the downloaded Citrix Workspace app installation folder to a folder on the Configuration Manager server and launch the Configuration Manager console.

  2. Select Software Library > Application Management. Right-click Application and click Create Application. The Create Application wizard appears.

  3. In the General pane, select Manually specify the application information and click Next.

  4. In the General Information pane, specify the application information, such as Name, Manufacturer, Software version.

  5. In the Application Catalog wizard, specify additional information such as Language, Application name, User category and so on and click Next.

    Note:

    Users can see the information that you specify here.

  6. In the Deployment Type pane, click Add to configure the deployment type for Citrix Workspace app setup.

    The Create Deployment Type wizard appears.

  7. In the General pane: Set the deployment type to Windows Installer (*.msi file), select Manually specify the deployment type information, and click Next.
  8. In the General Information pane: Specify deployment type details (For example: Workspace Deployment) and click Next.
  9. In the Content pane:

    1. Provide the path where the Citrix Workspace app setup file is present. For example: Tools on SCCM server.
    2. Specify Installation program as one of the following:
      • CitrixWorkspaceApp.exe /silent for default silent installation.
      • CitrixWorkspaceApp.exe /silent /includeSSON to enable domain pass-through.
      • CitrixWorkspaceApp.exe /silent SELFSERVICEMODE=false to install Citrix Workspace app in non-Self Service Mode.
    3. Specify Uninstall program as CitrixWorkspaceApp.exe /silent /uninstall (to enable uninstallation through SCCM).
  10. In the Detection Method pane: Select Configure rules to detect the presence of this deployment type and click Add Clause. The Detection Rule dialog appears.

    • Set Setting Type to File System.
    • Under Specify the file or folder to detect the application, set the following:
      • Type – From the drop-down menu, select File.
      • Path%ProgramFiles(x86)%\Citrix\ICA Client\Receiver\
      • File or folder namereceiver.exe
      • Property – From the drop-down menu, select Version
      • Operator - From the drop-down menu, select Greater than or equal to
      • Value - Type 4.3.0.65534

    Note:

    This rule combination applies to Citrix Workspace app for Windows upgrades as well.

  11. In the User Experience pane, set:

    • Installation behavior - Install for system
    • Logon requirement - Whether a user is logged on
    • Installation program visibility - Normal Click Next.

    Note:

    Do not specify any requirements and dependencies for this deployment type.

  12. In the Summary pane, verify the settings for this deployment type. Click Next.

    A success message appears.

  13. In the Completion pane, a new deployment type (Workspace Deployment) is listed under the Deployment types.

  14. Click Next and click Close.

Add distribution points

  1. Right-click Citrix Workspace app in the Configuration Manager console and select Distribute Content.

    The Distribute Content wizard appears.

  2. In the Content Distribution pane, click Add > Distribution Points.

    The Add Distribution Points dialog appears.

  3. Browse to the SCCM server where the content is available and clicks OK.

    In the Completion pane, a success message appears

  4. Click Close.

Deploy Citrix Workspace app to the software center

  1. Right-click Citrix Workspace app in the Configuration Manager console select Deploy.

    The Deploy Software wizard appears.

  2. Select Browse against Collection (can be Device Collection or User Collection) where the application is to be deployed and click Next.

  3. In the Deployment Settings pane, set Action to Install and Purpose to Required (enables unattended installation). Click Next.

  4. In the Scheduling pane, specify the schedule to deploy the software on target devices.

  5. In the User Experience pane, set the User notifications behavior; select Commit changes at deadline or during a maintenance window (requires restart) and click Next to complete the Deploy Software wizard.

In the Completion pane, a success message appears.

Reboot the target endpoint devices (required only to start installation immediately).

On endpoint devices, Citrix Workspace app is visible in the Software Center under Available Software. Installation is triggered automatically based on the configured schedule. You can also schedule or install on demand. The installation status is displayed in the Software Center after the installation starts.

Creating device collections

  1. Launch the Configuration Manager console and click Assets and Compliance > Overview > Devices.

  2. Right-click Device Collections and select Create Device Collection.

    The Create Device Collection wizard appears.

  3. In the General pane, type the Name for the device and click Browse for Limiting collection.

    This determines the scope of devices, which can be one the default Device Collections created by SCCM. Click Next.

  4. In the Membership Rules pane, click Add Rule for filtering the devices.

    The Create Direct Membership Rule wizard appears.

    • In the Search for Resources pane, select the Attribute name based on the devices you want to filter and provide the Value for Attribute name to select the devices.
  5. Click Next. In the Select Resources pane, select the devices that are required to be part of the device collection.

    In the Completion pane, a success message appears.

  6. Click Close.

  7. In the Membership rules pane, a new rule is listed under Click Next.

  8. In the Completion pane, a success message appears. Click Close to complete the Create Device Collection wizard.

    The new device collection is listed in Device Collections. The new device collection is a part of the Device Collections while browsing in the Deploy Software wizard.

Note:

Configuring Citrix Workspace app using SCCM might fail when the MSIRESTARTMANAGERCONTROL attribute is set to False. As per our analysis, Citrix Workspace app for Windows is not the cause of this failure. Also, retrying might yield successful deployment.

Deploy Citrix Workspace app in Microsoft Endpoint Manager (Intune)

To deploy Citrix Workspace app – native Win 32 app in Microsoft Endpoint Manager (Intune), do the following:

  1. Create the following folders:

    • A folder to store all the source files required for the installation, for example, C:\CitrixWorkspace_Executable.

    • A folder for the output file. Output files are in .intunewin file, for example, C:\Intune_CitrixWorkspaceApp.

    • A folder for the Microsoft Win32 Content Prep Tool, for example, C:\Intune_WinAppTool. This tool helps to convert the installation files into the .intunewin format. You can download the packaging tool from Microsoft-Win32-Content-Prep-Tool.

  2. Convert all the source files that are needed for the installation to a .intunewin file:

    1. Launch the command prompt and go to the folder, where the Microsoft Win32 Content Prep Tool exists, for example, C:\Intune_WinAppTool.
    2. Run the IntuneWinAppUtil.exe command.
    3. On the prompt, enter the following information:
      • Source folder: C:\CitrixWorkspace_Executable
      • Setup file: CitrixWorkspaceApp.exe
      • Output folder: C:\Intune_CitrixWorkspaceApp The .intunewin file is created.
  3. Add the package to Microsoft Endpoint Manager (Intune):

    1. Open the Microsoft Endpoint Manager (Intune) console: https://endpoint.microsoft.com/#home.

      Note:

      The following instruction can be performed only on https://endpoint.microsoft.com/#home. You can also add the package through https://portal.azure.com.

    2. Click Apps > Windows app and then click +Add.
    3. Select Windows app (Win 32) from the App type drop-down list.
    4. Click App package file, locate the CitrixWorkspaceApp.intunewin file, and then click OK.
    5. Click App information and fill in the mandatory information, Name, Description, and Publisher and then click OK.
    6. Click Program, enter the following information, and click OK:
      • Install command: CitrixWorkspaceApp.exe /silent
      • Uninstall command: CitrixWorkspaceApp.exe /uninstall
      • Install behavior: System
    7. Click Requirement, enter the required information, and then click OK.

      Note:

      Select both x64 and x32 from the Operation System Architecture list. Operation System version can be anything with Win 1607 and later.

    8. Click Detection rules, select Manually configure detection rules as the Rules format, and then click OK.
    9. Click Add, select the required Rule type, and then click OK.
      • If Rule type is File then the path can be, for example, C:\Program Files (x86)\Citrix\ICA Client\wfica32.exe.
      • If Rule type is Registry, then enter HKEY_CURRENT_USER\Software\Citrix as Path and Key exists as the Detection method.
    10. Click Return codes, check if the default return codes are valid and then click OK.
    11. Click Add to add the app to Intune.
  4. Verify if the deployment is successful:

    1. Click Home > Apps > Windows.
    2. Click Device install status.

      Device status displays the number of devices where Citrix Workspace app is installed.

Deploy