Installing the Unified Service Desk client

Make sure your computer meets all requirements before you install the Unified Service Desk client. More information: Unified Service Desk system requirements

Download the appropriate Unified Service Desk client setup file (.exe), and save it on your computer:

  • For a 32-bit version of Windows, download the Dynamics365-USD-4.x.x.xxx-i386.exe file.

  • For a 64-bit version of Windows, download the Dynamics365-USD-4.x.x.xxx-amd64.exe file.

  • For a 32-bit version of Windows, download the Dynamics365-USD-3.x.x.xxx-i386.exe file.

  • For a 64-bit version of Windows, download the Dynamics365-USD-3.x.x.xxx-amd64.exe file.

Install the Unified Service Desk client using the Setup Wizard

  1. Sign in as a user with local Administrators group membership, and then double-click the downloaded file to begin Setup.

  2. The Unified Service Desk client installer starts automatically. If it doesn’t, go to the folder where the extracted installation files are located and run the SetupUnifiedServiceDesk.exe file to start the installation.

  3. On the Microsoft Dynamics 365 for Customer Engagement apps Unified Service Desk screen, keep the default location or enter the complete path where the Unified Service Desk client application files will be installed, and then click Next.

  4. On the Microsoft Dynamics 365 for Customer Engagement apps Unified Service Desk Installation screen, choose from the following options:

    • The Microsoft .NET Framework and Windows Identity Foundation prerequisites. You can’t remove these from the installation if these prerequisites are not already installed.

    • Unified Service Desk. Because Unified Service Desk is the core component of setup, you cannot continue unless it is selected.

    • Create a desktop shortcut for Unified Service Desk. By default, a shortcut will be created for easy launching of the Unified Service Desk client from the desktop.

  5. Click Install.

  6. The next screen shows the installation status of the Unified Service Desk client. When you are prompted to authorize the installation (as a result of User Account Control), click Yes.

  7. A confirmation message appears on successful installation of the Unified Service Desk client. Click X to exit the installer or click Launch to start the Unified Service Desk client.

Upgrade the Unified Service Desk client using the Setup Wizard

  1. On a computer where a previous version of the Unified Service Desk client is installed, sign in to the computer as a user with local Administrators group membership, and then double-click the SetupUnifiedServiceDesk.exe file to begin the upgrade.

  2. When setup detects the previous version of the Unified Service Desk client, you'll see the following information:

    An older version of Unified Service Desk is already installed on your computer. Setup will upgrade Unified Service Desk on your computer.

  3. Click Next.

  4. On the Unified Service Desk Upgrade screen, decide if you want to create a shortcut for the Unified Service Desk client.

  5. The next screen shows the installation status of the Unified Service Desk client.

  6. A confirmation message appears on successful upgrade of the Unified Service Desk client. Click X to exit the installer or click Launch to start the Unified Service Desk client.

Install or upgrade the Unified Service Desk client in silent mode

When Unified Service Desk setup runs in silent mode, no user interface (UI) is displayed. Instead, you supply the required information at the command prompt.

Note

  • You may be prompted to supply the information due to the computer’s User Account Control Settings. To suppress this message when setup runs, set the User Account Control Setting to Never notify. After setup is complete, we recommend you set the User Account Control Setting back to the original notification level.
  • When the .NET Framework is installed as part of Unified Service Desk client setup, a restart may be required for setup to continue.

Command line syntax

SetupUnifiedServiceDesk.exe [destination] [Shortcut = [y | n]] [/S] [install/uninstall/help]

Parameters

Parameter Description
install

uninstall

help
Required parameter that performs one of the following functions depending on which parameter you choose:

- Install. Installs or, if a previous version exists, upgrades the Unified Service Desk client.
- Uninstall. Uninstalls the Unified Service Desk client. This is a maintenance mode option that is only available when the application is already installed.
- Help. Shows information about setup, such as supported parameters and usage.
/S Silent mode. No setup UI is displayed.
destination The folder where the Unified Service Desk client files will be installed. By default, Unified Service Desk is installed in the c:\program files\Microsoft Dynamics 365 for Customer Engagement USD\ folder.
Shortcut = [y | n] Shortcut=y creates a shortcut to the Unified Service Desk application on the user’s desktop. If you don’t set this parameter, the shortcut is defaulted to y. When you specify Shortcut=n, a shortcut is not created.
help Shows a list of valid parameters.

Examples

This example installs or upgrades the Unified Service Desk client in silent mode, creates a shortcut on the desktop.

SetupUnifiedServiceDesk.exe install Shortcut=y /S  

This example uninstalls the Unified Service Desk client. Note that no UI displays, even when the /S parameter is not used.

SetupUnifiedServiceDesk.exe uninstall  

Next Step

Deploy the Unified Service Desk sample packages on the Dynamics 365 Server. For more information, see Deploy Unified Service Desk packages to Dynamics 365 for Customer Engagement server using Package Deployer.

Known issues

Unified Service Desk client setup (SetupUnifiedServiceDesk.exe) hangs after you click Install

This can happen when you run setup as a user who does not have local Administrators group membership, using “Run as different user”, and when some Windows User Account Control (UAC) settings have been changed from the default, for example, if the Admin Approval Mode for the Built-in Administrator account UAC setting is set to Disabled on the local computer where setup runs. By default, Admin Approval Mode for the built-in Administrator account is enabled, but can be disabled through a Group Policy change.

See also

Install and Deploy Unified Service Desk
Update Unified Service Desk