Install the Unified Service Desk client

Article
06/27/2024

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.

Install the Unified Service Desk client using the Setup Wizard

Sign in as a user with local Administrators group membership, and then double-click the downloaded file to begin the setup.
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.
On the 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 select Next.
On the 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.
Select Install.
The next screen shows the installation status of the Unified Service Desk client. When you're prompted to authorize the installation (as a result of User Account Control), select Yes.
A confirmation message appears on successful installation of the Unified Service Desk client. Select X to exit the installer or select Launch to start the Unified Service Desk client.

Upgrade the Unified Service Desk client using the Setup Wizard

Important

Clear the cache before and after you upgrade your Unified Service Desk client. The cache is located at: %appData%\Roaming\Microsoft\USD. More information: Configure client caching

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.
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.
Select Next.
On the Unified Service Desk Upgrade screen, decide if you want to create a shortcut for the Unified Service Desk client.
The next screen shows the installation status of the Unified Service Desk client.
A confirmation message appears on successful upgrade of the Unified Service Desk client. Select X to exit the installer or select 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 that 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 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 Microsoft Dataverse. For more information, see Deploy Unified Service Desk packages to a Dataverse platform using Package Deployer.

Share via