mirror of
https://github.com/MicrosoftDocs/windows-itpro-docs.git
synced 2025-05-27 20:57:23 +00:00
374 lines
20 KiB
Markdown
374 lines
20 KiB
Markdown
---
|
||
title: Managing the UE-V 2.x Agent and Packages with Windows PowerShell and WMI
|
||
description: Managing the UE-V 2.x Agent and Packages with Windows PowerShell and WMI
|
||
author: jamiejdt
|
||
ms.assetid: 56e6780b-8b2c-4717-91c8-2af63062ab75
|
||
ms.pagetype: mdop, virtualization
|
||
ms.mktglfcycl: deploy
|
||
ms.sitesec: library
|
||
ms.prod: w10
|
||
ms.date: 08/30/2016
|
||
---
|
||
|
||
|
||
# Managing the UE-V 2.x Agent and Packages with Windows PowerShell and WMI
|
||
|
||
|
||
You can use Windows Management Instrumentation (WMI) and Windows PowerShell to manage Microsoft User Experience Virtualization (UE-V) 2.0, 2.1, and 2.1 SP1 Agent configuration and synchronization behavior. For a complete list of UE-V PowerShell cmdlets, see [UE-V 2 Cmdlet Reference](https://go.microsoft.com/fwlink/?LinkId=393495) (https://go.microsoft.com/fwlink/?LinkId=393495).
|
||
|
||
**To deploy the UE-V Agent by using Windows PowerShell**
|
||
|
||
1. Stage the UE-V installer file in an accessible network share.
|
||
|
||
**Note**
|
||
Use AgentSetup.exe to deploy both 32-bit and 64-bit versions of the UE-V Agent. Windows Installer packages, AgentSetupx86.msi and AgentSetupx64.msi, are available for each architecture. To uninstall the UE-V Agent at a later time by using the installation file, you must use the same file type.
|
||
|
||
|
||
|
||
2. Use one of the following Windows PowerShell commands to install the UE-V Agent.
|
||
|
||
- `& AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\\server\settingsshare\%username%`
|
||
|
||
- `& msiexec.exe /i "<path to msi file>" /quiet /norestart /l*v "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\\server\settingsshare\%username%`
|
||
|
||
**To configure the UE-V Agent by using Windows PowerShell**
|
||
|
||
1. Open a Windows PowerShell window. To manage computer settings that affect all users of the computer by using the *Computer* parameter, open the window with an account that has administrator rights.
|
||
|
||
2. Use the following Windows PowerShell commands to configure the agent.
|
||
|
||
<table>
|
||
<colgroup>
|
||
<col width="50%" />
|
||
<col width="50%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="header">
|
||
<th align="left">Windows PowerShell command</th>
|
||
<th align="left">Description</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Get-UevConfiguration</code></p>
|
||
<p></p></td>
|
||
<td align="left"><p>Gets the effective UE-V Agent settings. User-specific settings have precedence over the computer settings.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Get-UevConfiguration - CurrentComputerUser</code></p>
|
||
<p></p></td>
|
||
<td align="left"><p>Gets the UE-V Agent settings values for the current user only.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Get-UevConfiguration -Computer</code></p></td>
|
||
<td align="left"><p>Gets the UE-V Agent configuration settings values for all users on the computer.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Get-UevConfiguration -Details</code></p></td>
|
||
<td align="left"><p>Gets the details for each configuration setting. Displays where the setting is configured or if it uses the default value. Is displayed if the current setting is valid.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer –ContactITDescription <IT description></code></p></td>
|
||
<td align="left"><p>Sets the text that is displayed in the Company Settings Center for the help link.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer -ContactITUrl <string></code></p></td>
|
||
<td align="left"><p>Sets the URL of the link in the Company Settings Center for the help link. Any URL protocol can be used.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer –EnableDontSyncWindows8AppSettings</code></p></td>
|
||
<td align="left"><p>Configures the UE-V Agent to not synchronize any Windows apps for all users on the computer.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration -CurrentComputerUser – EnableDontSyncWindows8AppSettings</code></p></td>
|
||
<td align="left"><p>Configures the UE-V Agent to not synchronize any Windows apps for the current computer user.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer –EnableFirstUseNotification</code></p></td>
|
||
<td align="left"><p>Configures the UE-V Agent to display notification the first time the agent runs for all users on the computer.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer –DisableFirstUseNotification</code></p></td>
|
||
<td align="left"><p>Configures the UE-V Agent to not display notification the first time that the agent runs for all users on the computer.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer –EnableSettingsImportNotify</code></p></td>
|
||
<td align="left"><p>Configures the UE-V Agent to notify all users on the computer when settings synchronization is delayed.</p>
|
||
<p>Use the <em>DisableSettingsImportNotify</em> parameter to disable notification.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration - CurrentComputerUser -EnableSettingsImportNotify</code></p></td>
|
||
<td align="left"><p>Configures the UE-V Agent to notify the current user when settings synchronization is delayed.</p>
|
||
<p>Use the <em>DisableSettingsImportNotify</em> parameter to disable notification.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer –EnableSyncUnlistedWindows8Apps</code></p></td>
|
||
<td align="left"><p>Configures the UE-V Agent to synchronize all Windows apps that are not explicitly disabled by the Windows app list for all users of the computer. For more information, see "Get-UevAppxPackage" in [Managing UE-V 2.x Settings Location Templates Using Windows PowerShell and WMI](managing-ue-v-2x-settings-location-templates-using-windows-powershell-and-wmi-both-uevv2.md).</p>
|
||
<p>Use the <em>DisableSyncUnlistedWindows8Apps</em> parameter to configure the UE-V Agent to synchronize only Windows apps that are explicitly enabled by the Windows App List.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration - CurrentComputerUser - EnableSyncUnlistedWindows8Apps</code></p></td>
|
||
<td align="left"><p>Configures the UE-V Agent to synchronize all Windows apps that are not explicitly disabled by the Windows app list for the current user on the computer. For more information, see "Get-UevAppxPackage" in [Managing UE-V 2.x Settings Location Templates Using Windows PowerShell and WMI](managing-ue-v-2x-settings-location-templates-using-windows-powershell-and-wmi-both-uevv2.md).</p>
|
||
<p>Use the <em>DisableSyncUnlistedWindows8Apps</em> parameter to configure the UE-V Agent to synchronize only Windows apps that are explicitly enabled by the Windows App List.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration –Computer –DisableSync</code></p></td>
|
||
<td align="left"><p>Disables UE-V for all the users on the computer.</p>
|
||
<p>Use the <em>EnableSync</em> parameter to enable or re-enable.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration –CurrentComputerUser -DisableSync</code></p></td>
|
||
<td align="left"><p>Disables UE-V for the current user on the computer.</p>
|
||
<p>Use the <em>EnableSync</em> parameter to enable or re-enable.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer –EnableTrayIcon</code></p></td>
|
||
<td align="left"><p>Enables the UE-V icon in the notification area for all users of the computer.</p>
|
||
<p>Use the <em>DisableTrayIcon</em> parameter to disable the icon.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes></code></p></td>
|
||
<td align="left"><p>Configures the UE-V agent to report when a settings package file size reaches the defined threshold for all users on the computer. Sets the threshold package size in bytes.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes></code></p></td>
|
||
<td align="left"><p>Configures the UE-V agent to report when a settings package file size reaches the defined threshold. Sets the package size warning threshold for the current user.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds</code></p></td>
|
||
<td align="left"><p>Specifies the time in seconds before the user is notified for all users of the computer</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration - CurrentComputerUser -SettingsImportNotifyDelayInSeconds</code></p></td>
|
||
<td align="left"><p>Specifies the time in seconds before notification for the current user is sent.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer -SettingsStoragePath <path to _settings_storage_location></code></p></td>
|
||
<td align="left"><p>Defines a per-computer settings storage location for all users of the computer.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to _settings_storage_location></code></p></td>
|
||
<td align="left"><p>Defines a per-user settings storage location.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration –Computer –SettingsTemplateCatalogPath <path to catalog></code></p></td>
|
||
<td align="left"><p>Sets the settings template catalog path for all users of the computer.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer -SyncMethod <sync method></code></p></td>
|
||
<td align="left"><p>Sets the synchronization method for all users of the computer: SyncProvider or None.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method></code></p></td>
|
||
<td align="left"><p>Sets the synchronization method for the current user: SyncProvider or None.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds></code></p></td>
|
||
<td align="left"><p>Sets the synchronization time-out in milliseconds for all users of the computer</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Set- UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds></code></p></td>
|
||
<td align="left"><p>Set the synchronization time-out for the current user.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Clear-UevConfiguration –Computer -<setting name></code></p></td>
|
||
<td align="left"><p>Clears the specified setting for all users on the computer.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Clear-UevConfiguration –CurrentComputerUser -<setting name></code></p></td>
|
||
<td align="left"><p>Clears the specified setting for the current user only.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Export-UevConfiguration <settings migration file></code></p></td>
|
||
<td align="left"><p>Exports the UE-V computer configuration to a settings migration file. The file name extension must be .uev.</p>
|
||
<p>The <code>Export</code> cmdlet exports all UE-V Agent settings that are configurable with the <em>Computer</em> parameter.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Import-UevConfiguration <settings migration file></code></p></td>
|
||
<td align="left"><p>Imports the UE-V computer configuration from a settings migration file. The file name extension must be .uev.</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
**To export UE-V package settings and repair UE-V templates by using Windows PowerShell**
|
||
|
||
1. Open a Windows PowerShell window as an administrator.
|
||
|
||
2. Use the following Windows PowerShell commands to configure the agent.
|
||
|
||
<table>
|
||
<colgroup>
|
||
<col width="50%" />
|
||
<col width="50%" />
|
||
</colgroup>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td align="left"><p><strong>Windows PowerShell command</strong></p></td>
|
||
<td align="left"><p><strong>Description</strong></p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p>Export-UevPackage MicrosoftCalculator6.pkgx</p></td>
|
||
<td align="left"><p>Extracts the settings from a Microsoft Calculator package file and converts them into a human-readable format in XML.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p>Repair-UevTemplateIndex</p></td>
|
||
<td align="left"><p>Repairs the index of the UE-V settings location templates.</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
**To configure the UE-V Agent by using WMI**
|
||
|
||
1. User Experience Virtualization provides the following set of WMI commands. Administrators can use this interface to configure the UE-V agent at the command line and automate typical configuration tasks.
|
||
|
||
Use an account with administrator rights to open a Windows PowerShell window.
|
||
|
||
2. Use the following WMI commands to configure the agent.
|
||
|
||
<table>
|
||
<colgroup>
|
||
<col width="50%" />
|
||
<col width="50%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="header">
|
||
<th align="left"><code>Windows PowerShell command</code></th>
|
||
<th align="left">Description</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Get-WmiObject -Namespace root\Microsoft\UEV Configuration</code></p>
|
||
<p></p></td>
|
||
<td align="left"><p>Displays the active UE-V Agent settings. User-specific settings have precedence over the computer settings.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration</code></p></td>
|
||
<td align="left"><p>Displays the UE-V Agent configuration that is defined for a user.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration</code></p></td>
|
||
<td align="left"><p>Displays the UE-V Agent configuration that is defined for a computer.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Get-WmiObject –Namespace root\Microsoft\Uev ConfigurationItem</code></p></td>
|
||
<td align="left"><p>Displays the details for each configuration item.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration</code></p>
|
||
<p><code>$config.SettingsStoragePath = <path_to_settings_storage_location></code></p>
|
||
<p>$config.Put()</p></td>
|
||
<td align="left"><p>Defines a per-computer settings storage location.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>$config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration</code></p>
|
||
<p><code>$config.SettingsStoragePath = <path_to_settings_storage_location></code></p>
|
||
<p><code>$config.Put()</code></p></td>
|
||
<td align="left"><p>Defines a per-user settings storage location.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration</code></p>
|
||
<p><code>$config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds></code></p>
|
||
<p><code>$config.Put()</code></p></td>
|
||
<td align="left"><p>Sets the synchronization time-out in milliseconds for all users of the computer.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration</code></p>
|
||
<p><code>$config.MaxPackageSizeInBytes = <size_in_bytes></code></p>
|
||
<p><code>$config.Put()</code></p></td>
|
||
<td align="left"><p>Configures the UE-V Agent to report when a settings package file size reaches a defined threshold. Set the threshold package file size in bytes for all users of the computer.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration</code></p>
|
||
<p><code>$config.SyncMethod = <sync_method></code></p>
|
||
<p><code>$config.Put()</code></p></td>
|
||
<td align="left"><p>Sets the synchronization method for all users of the computer: SyncProvider or None.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration</code></p>
|
||
<p><code>$config.<setting name> = $true</code></p>
|
||
<p><code>$config.Put()</code></p></td>
|
||
<td align="left"><p>To enable a specific per-computer setting, clear the setting, and use <em>$null</em> as the setting value. Use UserConfiguration for per-user settings.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration</code></p>
|
||
<p><code>$config.<setting name> = $false</code></p>
|
||
<p><code>$config.Put()</code></p></td>
|
||
<td align="left"><p>To disable a specific per-computer setting, clear the setting, and use <em>$null</em> as the setting value. Use User Configuration for per-user settings.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration</code></p>
|
||
<p><code>$config.<setting name> = <setting value></code></p>
|
||
<p><code>$config.Put()</code></p></td>
|
||
<td align="left"><p>Updates a specific per-computer setting. To clear the setting, use <em>$null</em> as the setting value.</p></td>
|
||
</tr>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration</code></p>
|
||
<p><code></code>$config.<setting name> = <setting value></p>
|
||
<p><code>$config.Put()</code></p></td>
|
||
<td align="left"><p>Updates a specific per-user setting for all users of the computer. To clear the setting, use <em>$null</em> as the setting value.</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
Upon configuration of the UE-V Agent with WMI and Windows PowerShell, the defined configuration is stored in the registry in the following locations.
|
||
|
||
`\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\UEV\Agent\Configuration`
|
||
|
||
`\HKEY_CURRENT_USER\SOFTWARE\Microsoft\UEV\Agent\Configuration`
|
||
|
||
**To export UE-V package settings and repair UE-V templates by using WMI**
|
||
|
||
1. UE-V provides the following set of WMI commands. Administrators can use this interface to export a package or repair UE-V templates.
|
||
|
||
2. Use the following WMI commands.
|
||
|
||
<table>
|
||
<colgroup>
|
||
<col width="50%" />
|
||
<col width="50%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="header">
|
||
<th align="left">WMI command</th>
|
||
<th align="left">Description</th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="odd">
|
||
<td align="left"><p><code>Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserSettings -Name ExportPackage -ArgumentList <package name></code></p></td>
|
||
<td align="left"><p>Extracts the settings from a package file and converts them into a human-readable format in XML.</p></td>
|
||
</tr>
|
||
<tr class="even">
|
||
<td align="left"><p><code>Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name RebuildIndex</code></p></td>
|
||
<td align="left"><p>Repairs the index of the UE-V settings location templates. Must be run as administrator.</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
|
||
|
||
|
||
**Got a suggestion for UE-V**? Add or vote on suggestions [here](http://uev.uservoice.com/forums/280428-microsoft-user-experience-virtualization). **Got a UE-V issue**? Use the [UE-V TechNet Forum](https://social.technet.microsoft.com/Forums/home?forum=mdopuev).
|
||
|
||
## Related topics
|
||
|
||
|
||
[Administering UE-V 2.x with Windows PowerShell and WMI](administering-ue-v-2x-with-windows-powershell-and-wmi-both-uevv2.md)
|
||
|
||
[Administering UE-V 2.x](administering-ue-v-2x-new-uevv2.md)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|