Skip to main content

Desktop agent

Command-line installation

This guide demonstrates how you can install idemeum desktop agent with a command line script.

Windows

Install with PowerShell

❗
Administrator permissions required to install idemeum desktop agent on Windows.
  • Navigate to your idemeum tenant admin portal
  • Access Devices → Installation
  • Choose Windows from the selection on the left
  • You will be presented with the command that you can copy and execute directly on the workstation
  • Now open PowerShell as Administrator and execute the idemeum PowerShell command. In case the client is already installed, PowerShell script will check if the client needs to be updated to the latest version, and will perform the update.
💡
Restart will be required after installation. You can bypass the restart by passing the additional command. Please check the Advanced Settings section below.

Uninstall with PowerShell

  • Open PowerShell as Administrator
  • To uninstall idemeum client and updater please execute the following PowerShell commands on the workstation
Start-Process -FilePath "msiexec.exe" -ArgumentList "/x {93B9CC98-6004-411E-A8BF-88F7C3BC5541} /qn /norestart" -Wait
Start-Process -FilePath "msiexec.exe" -ArgumentList "/x {71216D26-573B-402B-A3F5-A7CB9F950CFF} /qn /norestart" -Wait

You can execute the commands directly or you the following script.

idemeum-uninstall-agent
idemeum-uninstall-agent.ps1
233 Bytes
download-circle

Advanced installation settings

You can pass additional parameters to your PowerShell script to customize the behavior:

  • -restartAfterInstall - pass true or false depending on whether you want the computer to restart or not. We recommend to perform the restart after the installation to make sure the credential provider is properly loaded. The default value is true. See the example below.
  • -autofillEnabled - pass true or false depending on whether you want to enable autofill service for desktop applications. The default value is false.
  • -credentialProviderEnabled - pass true or false depending on whether you want to install idemeum credential provider. The default value is true.
  • -authType - pass the way you want users to authenticate, qrcode or rfid

macOS

Install with script

❗
Administrator permissions required to install idemeum desktop agent on MacOS.
  • Navigate to your idemeum tenant admin portal
  • Access Devices → Installation
  • Choose macOS from the selection on the left
  • You will be presented with the command that you can copy and execute directly on the workstation

Uninstall with script

❗
You need to be logged in as admin user.
  • Open terminal and execute the following command
curl -O https://asset.idemeum.com/desktoplogin/macos/idemeumMacDesktopUninstall.sh && chmod +x idemeumMacDesktopUninstall.sh && ./idemeumMacDesktopUninstall.sh