book
Article ID: CTX692725
calendar_today
Updated On:
Description
This article lists the steps to install the Citrix Profile Management WMI Plug-in on the VDA
Instructions
- The Citrix Profile Management WMI Plug-in plays a crucial role in monitoring and managing user logon duration by providing detailed information about the time taken to load a user's profile during login.
- The Citrix Profile Management WMI Plug-in allows Citrix Director to gather detailed performance metrics from the Profile Management service, enabling it to display precise user logon duration data within the Director interface.
- Citrix User Profile Manager and Citrix User Profile Manager WMI Plugin should be installed on the VDA and Citrix Profile Management Service should be running on the VDA for logon duration to be reported in Citrix Director. Reference: https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/director/troubleshoot-deployments/user-issues/user-logon.html#prerequisites
To install the Citrix Profile Management WMI Plug-in, you can follow these detailed steps.
Installation Steps via GUI:
-
Prepare for Installation:
- Ensure you have the Citrix Virtual Apps and Desktops ISO file available. This file contains the necessary components for installation.
2. Launch the Installation:
- Mount the Citrix Virtual Apps and Desktops ISO file on your system.
- Navigate to the mounted ISO and locate the "Autoselect" executable to start the installation process.
3. Select Components:
- During the installation wizard, you will be prompted to select the components you wish to install.
- Make sure to select Citrix Profile Management and Citrix Profile Management WMI Plugin. You can also select any other components that are required for your deployment.

4. After installation, check the directory C:\Program Files\Citrix\Virtual Desktop Agent\ to ensure the below WMI plug-in files are present to confirm successful installation:
upmWmiAdmin.dll
upmWmiMetrics.dll
upmWmiPlugin.dll
- To check the logon timings data, you can use the following PowerShell command. This class is used to collect and report logon duration metrics for user sessions in Citrix environments.
get-wmiobject -namespace root\citrix\profiles\metrics -class logontimings
Installation Steps via command line
- Prepare for Installation:
- Ensure you have administrative rights on the machine where you will install the plug-in.
- Download the Citrix Virtual Apps and Desktops installation package that includes the Profile Management components.
- Run the Installer:
- Navigate to the directory where the installation package is located.
- Open a command prompt with administrative privileges.
- Execute the Command:
- Use the following command to install the Virtual Delivery Agent (VDA) along with the Profile Management WMI Plug-in. Example:
VDAServerSetup_xxx.exe /controllers 'controllersfqdn' /noresume /noreboot /quiet /disableexperiencemetrics /virtualmachine /optimize /logpath 'logpath' /includeadditional 'Citrix Profile Management WMI Plug-in' /components 'vda'
- Replace 'controllersfqdn' with the fully qualified domain name of your Delivery Controller and 'logpath' with the desired path for log files.
- Verify Installation:
- After installation, check the following directory to ensure the WMI plug-in files are present:
- C:\Program Files\Citrix\Virtual Desktop Agent\
- Look for the files listed below to confirm successful installation
upmWmiAdmin.dll
upmWmiMetrics.dll
upmWmiPlugin.dll
5. Restart the Machine:
- It is recommended to restart the machine after installation to ensure all components are loaded correctly.