Skip to content

Latest commit

 

History

History
127 lines (76 loc) · 11.7 KB

install-upgrade-unified-service-desk-client.md

File metadata and controls

127 lines (76 loc) · 11.7 KB
Raw
title description ms.date ms.topic author ms.author search.audienceType ms.custom tags
Install the Unified Service Desk client | MicrosoftDocs
Learn how to install and upgrade Unified Service Desk client using the Setup Wizard and using the command line.
06/27/2024
article
gandhamm
mgandham
admin
evergreen
MigrationHO

Install the Unified Service Desk client

Make sure your computer meets all requirements before you install the [!INCLUDEpn_unified_service_desk] client. [!INCLUDEproc_more_information] Unified Service Desk system requirements

Download the appropriate [!INCLUDEpn_unified_service_desk] client setup file (.exe), and save it on your computer:

::: moniker range=">=dynamics-usd-4"

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

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

::: moniker-end

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 the setup.

  2. The [!INCLUDEpn_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 Unified Service Desk screen, keep the default location or enter the complete path where the [!INCLUDEpn_unified_service_desk] client application files will be installed, and then select Next.

  4. On the Unified Service Desk Installation screen, choose from the following options:

    • The [!INCLUDEpn_Microsoft_.Net_Framework] and [!INCLUDEpn_Windows_Identity_Foundation] prerequisites. You can’t remove these from the installation if these prerequisites are not already installed.

    • Unified Service Desk. Because [!INCLUDEpn_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 [!INCLUDEpn_unified_service_desk] client from the desktop.

  5. Select Install.

  6. The next screen shows the installation status of the [!INCLUDEpn_unified_service_desk] client. When you're prompted to authorize the installation (as a result of User Account Control), select Yes.

  7. A confirmation message appears on successful installation of the [!INCLUDEpn_unified_service_desk] client. Select X to exit the installer or select Launch to start the [!INCLUDEpn_unified_service_desk] client.

Upgrade the Unified Service Desk client using the Setup Wizard

::: moniker range="=dynamics-usd-4.2"

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

::: moniker-end

  1. On a computer where a previous version of the [!INCLUDEpn_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 [!INCLUDEpn_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. Select Next.

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

  5. The next screen shows the installation status of the [!INCLUDEpn_unified_service_desk] client.

  6. A confirmation message appears on successful upgrade of the [!INCLUDEpn_unified_service_desk] client. Select X to exit the installer or select Launch to start the [!INCLUDEpn_unified_service_desk] client.

Install or upgrade the Unified Service Desk client in silent mode

When [!INCLUDEpn_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 [!INCLUDEpn_NET_Framework] is installed as part of [!INCLUDEpn_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 [!INCLUDEpn_unified_service_desk] client.
- Uninstall. Uninstalls the [!INCLUDEpn_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 [!INCLUDEpn_unified_service_desk] client files will be installed. By default, [!INCLUDEpn_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 [!INCLUDEpn_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 [!INCLUDEpn_unified_service_desk] client in silent mode, creates a shortcut on the desktop.

SetupUnifiedServiceDesk.exe install Shortcut=y /S

This example uninstalls the [!INCLUDEpn_unified_service_desk] client. Note that no UI displays, even when the /S parameter is not used.

SetupUnifiedServiceDesk.exe uninstall

Next Step

Deploy the [!INCLUDEpn_unified_service_desk] sample packages on Microsoft Dataverse. For more information, see Deploy Unified Service Desk packages to a Dataverse platform using Package Deployer.

See also

Install and deploy Unified Service Desk
Update Unified Service Desk

[!INCLUDEfooter-include]