--- title: Installing the desktop app (legacy) using the Windows CLI description: Install the PingID desktop app (legacy) using the command-line interface (CLI). This is useful for deploying on multiple machines in batch mode. component: pingid page_id: pingid:pingid_service_management:installing_pid_desktop_app_using_windows_cli canonical_url: http://docs.pingidentity.com/pingid/pingid_service_management/installing_pid_desktop_app_using_windows_cli.html revdate: May 18, 2023 section_ids: about-this-task: About this task steps: Steps examplecusersadmindownloadspingid-1-5-0-exe-verysilent-suppressmsgboxes-sp-logcusersadmintemplogspingiddesktopapplog-log: "Example:C:\\Users\\Admin\\Downloads\\PingID-1.5.0.exe /VERYSILENT /SUPPRESSMSGBOXES /SP- /LOG=\"C:\\Users\\Admin\\Temp\\Logs\\PingIDDesktopAppLog.log\"" --- # Installing the desktop app (legacy) using the Windows CLI Install the PingID desktop app (legacy) using the command-line interface (CLI). This is useful for deploying on multiple machines in batch mode. ## About this task | | | | - | ------------------------------------------------------------------------------- | | | Running the installer from the command line requires administrator permissions. | ## Steps 1. Download the PingID desktop app (legacy) installer from the [PingID desktop download page](https://downloads.pingidentity.com/pingid/pc-client/PingID.exe). 2. Open a Command Prompt window with administrator permissions. 3. Create a `.bat` or `.cmd` file containing the following commands for the PingID desktop app (legacy), or run the installer directly from the command line, to supply the parameter values. `\PingID-.exe [/SILENT][/VERYSILENT] [/TASKS="roaminguserprofiles"] [/SUPPRESSMSGBOXES] [/SP-] ][/DIR]` The following table describes each parameter value. | Parameter | Description | | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `/SILENT` or `/VERYSILENT` | The background window and installation progress window are displayed by default. To hide them, include one of the following parameters.- `/SILENT` Hides the background window and shows the installation process window. - `/VERYSILENT` Hides the background window and the installation process window. | | `/TASKS=``"roaminguserprofiles"` | To add support for roaming user profiles, append this parameter. Available for version 1.5.3 and later. There are several conditions to its use.When the parameter is not used in a fresh installation:- When using the `/SILENT` or `/VERYSILENT` parameters, the UI is not shown and the roaming profile setting is unavailable. - Otherwise, the roaming profile setting is shown in the UI unchecked, and can be changed by the user.When the parameter is used in a fresh installation:- In SILENT or VERYSILENT mode, the UI is not shown and roaming profile is used. - Otherwise, the roaming profile setting is shown in the UI as checked, and can be changed by the user.For an upgrade from a previous version or reinstall of the same version:- This CLI setting is ignored. - In SILENT or VERYSILENT mode, the UI is not shown. The previous installation setup is maintained. - Otherwise, the UI will be shown but the roaming profile check box will be not be shown. | | `/SP-` | Disables the prompt `"This will install…​ Do you wish to continue?"` that appears by default when the installation starts. | | `/SUPPRESSMSGBOXES` | Instructs the installer to suppress message boxes. It only has an effect when combined with `/SILENT` or `/VERYSILENT`. The default response in situations where there's a choice is:- `Yes` in `Keep newer file?` situations. - `No` in `File exists, confirm overwrite` situations. - `Abort` in \`Abort/Retry` situations. - `Cancel` in `Retry/Cancel` situations. - `Yes` (continue) in `DiskSpaceWarning, DirExists, DirDoesntExist, NoUninstallWarning, ExitSetupMessage,`and `ConfirmUninstall` situations. - `Yes` (restart) in `FinishedRestartMessage` and`UninstalledAndNeedsRestart` situations. | | `/LOG=`` `` ` | * `/LOG`< without an assigned value will create a log file in the user's TEMP directory, detailing file installation and actions taken during the installation process. * /`LOG=` allows you to specify a fixed path or filename to use for the log file. If a file with the specified name already exists, it will be overwritten. If the file cannot be created, the installer will abort with an error message. | | `/DIR=`\ | Defines the path to which you want to install the app. A fully qualified pathname must be specified in the format` x:\directorypath`. If no path is defined, the default path is used. | ### Example:`C:\Users\Admin\Downloads\PingID-1.5.0.exe /VERYSILENT /SUPPRESSMSGBOXES /SP- /LOG="C:\Users\Admin\Temp\Logs\PingIDDesktopAppLog.log"` This example instructs the installer to install the PingID desktop app (legacy), with the following settings: * Runs the installer executable, located in the Downloads folder. * Does not display the background window and installation progress window (`/VERYSILENT` parameter). * Does not display message boxes and prompts (`/SUPPRESSMSGBOXES` and `/SP-` parameters). * Sends the log output to a customized destination (`/LOG` parameter). 4. To verify the installation, test that a user can open the PingID desktop app (legacy) instance on their Windows machine and pair their device. For more information, see [Setting up PingID desktop authentication on Windows](http://docs.pingidentity.com/pingid-user-guide/secure_authentication_with_pingid/ug_pid_desktop_app_web.html).