- Created by Karolin Hemmingsson, last modified by Ann Base on Aug 31, 2022
This article describes how to install Smart ID Desktop App. The commands are issued on each individual computer.
No administrative rights are necessary to install Smart ID Desktop App, and the app does not affect the Windows Registry.
Prerequisites
Install Smart ID Desktop App
- Go to https://www.microsoft.com/store/apps/9P7MDNFPMMDG and download the app.
- Download the Smart ID Desktop App installation from Nexus Support portal.
To install Smart ID Desktop App:
Run the file Smart ID Desktop App-<version>.msi
ORenter the command:
Install Smart ID Desktop Appmsiexec.exe /i Smart ID Desktop App-<version>.msi [allowcreatevsc=true target=allusers registerid06=true metapath=[json metadata path]]
If you shall use the optional parameters you have to run the command as admin
The optional parameters to the msiexec installation are described below.
| Parameter | Description |
|---|---|
| allowcreatevsc=true | With this option, the administrator gives permanent consent to enable VSC creation. The consent allows Smart ID Desktop App to carry the whole VSC creation process itself for any (even non -admin) user. There is no longer a need to use the FreeTPM option. It can also be set with the toggle button Grant permission to create VSCs in advanced settings. See Do advanced settings in Smart ID Desktop App for more information. Read more technical details here: Smart ID Desktop App installer - technical details |
| target=allusers | With this option, the administrator gives consent to provision Smart ID Desktop App on the whole machine and accessible for each user (upon next log in). Read more technical details here: Smart ID Desktop App installer - technical details |
| registerid06=true | With this option, the administrator can register Key Storage Provider (KSP) with the ID06 card. You can also do this in the Smart ID Desktop App GUI, under Advanced Settings by clicking Register key storage provider under the ID06 heading. See step 5 in Do advanced settings in Smart ID Desktop App for more information. |
| metapath=[json metadata path] | With this option, metadata is imported directly during install. The structure of the .json file is the one used for metadata import via the metadata tool. Read more about the topic here: Smart ID Desktop App metadata tool. |
The json metadata path can have one of these forms:
- metapath="[json file full path]". Beware that in powershell the quotes need to be escaped (the escape character in powershell is ALT+96, i.e the symbol `).
- or in simplified version metapath=[fileName.json], which can be used if [fileName.json] is saved either in the same folder as the msi or in the current cmd/powershell location.
Uninstall Smart ID Desktop App
To uninstall Smart ID Desktop App enter the command:
msiexec /i Smart ID Desktop App-<version>.msi [target=allusers] UNINSTALL=true
If you shall use the optional parameter you have to run the command as admin
Upgrade Smart ID Desktop App
When you upgrade Smart ID Desktop App, all the metadata, including any existing profiles, are preserved.
- Open Microsoft Store.
- Click ... (See more).
- Select Downloads and update.
Download the Smart ID Desktop App installation from Nexus Support portal.
Run the file Smart ID Desktop App-<version>.msi.
Troubleshooting
You find the log files here:
- Open the Event Viewer in Windows.
- Go to Applications and Service Logs > Microsoft > Windows > AppXDeployment-Server.
- There you find Microsoft-Windows-AppXDeploymentServer/Operational which contains the events.
To generate msiexec logs:
Extend the command with "/l log.log", which will produce a log.log file in the current command line location. For example:
msiexec /i Smart ID Desktop App-<version>.msi [target=allusers] /l log.log
This article is valid for Smart ID Desktop App 1.8.7 and later.