Freigeben über

Verwalten des UE-V 2.1 SP1-Agents und der Pakete mit Windows PowerShell und WMI

  • Artikel

Sie können die Windows-Verwaltungsinstrumentation (WMI) und Windows PowerShell verwenden, um die Konfiguration und das Synchronisierungsverhalten des Agents für Microsoft User Experience Virtualization (UE-V) 2.1 SP1 zu verwalten. Eine vollständige Liste der UE-V PowerShell-Cmdlets finden Sie in der MDOP-Cmdlet-Referenz.

So stellen Sie den UE-V-Agent mithilfe von Windows PowerShell bereit

  1. Stellen Sie die UE-V-Installationsdatei in einer zugänglichen Netzwerkfreigabe ein.

    Hinweis

    Verwenden Sie AgentSetup.exe, um sowohl 32-Bit- als auch 64-Bit-Versionen des UE-V-Agents bereitzustellen. Windows Installer-Pakete AgentSetupx86.msi und AgentSetupx64.msi sind für jede Architektur verfügbar. Um den UE-V-Agent zu einem späteren Zeitpunkt mithilfe der Installationsdatei zu deinstallieren, müssen Sie denselben Dateityp verwenden.

  2. Verwenden Sie zum Installieren des UE-V-Agents einen der folgenden Windows PowerShell-Befehle:

& 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%

So konfigurieren Sie den UE-V-Agent mithilfe von Windows PowerShell

  1. Öffnen Sie ein Windows PowerShell-Fenster. Um Computereinstellungen zu verwalten, die sich auf alle Benutzer des Computers auswirken, indem Sie den Parameter Computer verwenden, öffnen Sie das Fenster mit einem Konto, das über Administratorrechte verfügt.

  2. Verwenden Sie die folgenden Windows PowerShell-Befehle, um den Agent zu konfigurieren.

Windows PowerShell-Befehl Beschreibung
Get-UevConfiguration Ruft die effektiven Einstellungen des UE-V-Agents ab. Benutzerspezifische Einstellungen haben Vorrang vor den Computereinstellungen.
Get-UevConfiguration -CurrentComputerUser Ruft nur die UE-V-Agent-Einstellungswerte für den aktuellen Benutzer ab.
Get-UevConfiguration -Computer Ruft die Konfigurationseinstellungen des UE-V-Agents für alle Benutzer auf dem Computer ab.
Get-UevConfiguration -Details Ruft die Details für jede Konfigurationseinstellung ab. Zeigt an, wo die Einstellung konfiguriert ist oder ob der Standardwert verwendet wird. Wird angezeigt, wenn die aktuelle Einstellung gültig ist.
Set-UevConfiguration -Computer -ContactITDescription <IT description> Legt den Text fest, der im Unternehmenseinstellungscenter für den Hilfelink angezeigt wird.
Set-UevConfiguration -Computer -ContactITUrl <string> Legt die URL des Links im Unternehmenseinstellungscenter für den Hilfelink fest. Es kann ein beliebiges URL-Protokoll verwendet werden.
Set-UevConfiguration -Computer -EnableDontSyncWindows8AppSettings Konfiguriert den UE-V-Agent so, dass keine Windows-Apps für alle Benutzer auf dem Computer synchronisiert werden.
Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings Konfiguriert den UE-V-Agent so, dass keine Windows-Apps für den aktuellen Computerbenutzer synchronisiert werden.
Set-UevConfiguration -Computer -EnableFirstUseNotification Konfiguriert den UE-V-Agent so, dass Benachrichtigungen angezeigt werden, wenn der Agent zum ersten Mal für alle Benutzer auf dem Computer ausgeführt wird.
Set-UevConfiguration -Computer -DisableFirstUseNotification Konfiguriert den UE-V-Agent so, dass keine Benachrichtigung angezeigt wird, wenn der Agent zum ersten Mal für alle Benutzer auf dem Computer ausgeführt wird.
Set-UevConfiguration -Computer -EnableSettingsImportNotify Konfiguriert den UE-V-Agent so, dass alle Benutzer auf dem Computer benachrichtigt werden, wenn die Synchronisierung der Einstellungen verzögert wird. Verwenden Sie den Parameter DisableSettingsImportNotify , um die Benachrichtigung zu deaktivieren.
Set-UevConfiguration -CurrentComputerUser -EnableSettingsImportNotify Konfiguriert den UE-V-Agent so, dass er den aktuellen Benutzer benachrichtigt, wenn die Synchronisierung von Einstellungen verzögert wird. Verwenden Sie den Parameter DisableSettingsImportNotify , um die Benachrichtigung zu deaktivieren.
Set-UevConfiguration -Computer -EnableSyncUnlistedWindows8Apps Konfiguriert den UE-V-Agent so, dass alle Windows-Apps synchronisiert werden, die nicht explizit von der Windows-App-Liste für alle Benutzer des Computers deaktiviert werden. Verwenden Sie den DisableSyncUnlistedWindows8Apps Parameter, um den UE-V-Agent so zu konfigurieren, dass nur Windows-Apps synchronisiert werden, die explizit von der Windows-App-Liste aktiviert sind.
Set-UevConfiguration -CurrentComputerUser -EnableSyncUnlistedWindows8Apps Konfiguriert den UE-V-Agent für die Synchronisierung aller Windows-Apps, die nicht explizit von der Windows-App-Liste für den aktuellen Benutzer auf dem Computer deaktiviert wurden. Verwenden Sie den DisableSyncUnlistedWindows8Apps Parameter, um den UE-V-Agent so zu konfigurieren, dass nur Windows-Apps synchronisiert werden, die explizit von der Windows-App-Liste aktiviert sind.
Set-UevConfiguration -Computer -DisableSync Deaktiviert UE-V für alle Benutzer auf dem Computer. Verwenden Sie den Parameter EnableSync , um diese zu aktivieren oder erneut zu aktivieren.
Set-UevConfiguration -CurrentComputerUser -DisableSync Deaktiviert UE-V für den aktuellen Benutzer auf dem Computer. Verwenden Sie den Parameter EnableSync , um diese zu aktivieren oder erneut zu aktivieren.
Set-UevConfiguration -Computer -EnableTrayIcon Aktiviert das UE-V-Symbol im Infobereich für alle Benutzer des Computers. Verwenden Sie den Parameter DisableTrayIcon , um das Symbol zu deaktivieren.
Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes> Konfiguriert den UE-V-Agent so, dass er meldet, wenn die Größe einer Einstellungspaketdatei den definierten Schwellenwert für alle Benutzer auf dem Computer erreicht. Legt die Schwellenwertpaketgröße in Bytes fest.
Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes> Konfiguriert den UE-V-Agent so, dass er meldet, wenn die Größe einer Einstellungspaketdatei den definierten Schwellenwert erreicht. Legt den Schwellenwert für die Paketgröße für die Warnung für den aktuellen Benutzer fest.
Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds Gibt die Zeit in Sekunden an, bevor der Benutzer für alle Benutzer des Computers benachrichtigt wird.
Set-UevConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds Gibt die Zeit in Sekunden an, bevor die Benachrichtigung für den aktuellen Benutzer gesendet wird.
Set-UevConfiguration -Computer -SettingsStoragePath <path to settings storage location> Definiert einen Pro-Computer-Einstellungsspeicherort für alle Benutzer des Computers.
Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to settings storage location> Definiert einen Benutzereinstellungsspeicherort.
Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <path to catalog> Legt den Katalogpfad der Einstellungsvorlage für alle Benutzer des Computers fest.
Set-UevConfiguration -Computer -SyncMethod <sync method> Legt die Synchronisierungsmethode für alle Benutzer des Computers fest: SyncProvider oder None.
Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method> Legt die Synchronisierungsmethode für den aktuellen Benutzer fest: SyncProvider oder None.
Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds> Legt das Synchronisierungstimeout in Millisekunden für alle Benutzer des Computers fest.
Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds> Legt das Synchronisierungstimeout für den aktuellen Benutzer fest.
Clear-UevConfiguration -Computer -<setting name> Löscht die angegebene Einstellung für alle Benutzer auf dem Computer.
Clear-UevConfiguration -CurrentComputerUser -<setting name> Löscht die angegebene Einstellung nur für den aktuellen Benutzer.
Export-UevConfiguration <settings migration file> Exportiert die UE-V-Computerkonfiguration in eine Einstellungsmigrationsdatei. Die Dateinamenerweiterung muss sein .uev. Das Export-Cmdlet exportiert alle UE-V-Agent-Einstellungen, die mit dem Computer-Parameter konfiguriert werden können.
Import-UevConfiguration <settings migration file> Importiert die UE-V-Computerkonfiguration aus einer Einstellungsmigrationsdatei. Die Dateinamenerweiterung muss sein .uev.

So exportieren Sie UE-V-Paketeinstellungen und reparieren UE-V-Vorlagen mithilfe von Windows PowerShell

  1. Öffnen Sie ein Windows PowerShell-Fenster als Administrator.

  2. Verwenden Sie die folgenden Windows PowerShell-Befehle, um den Agent zu konfigurieren.

    Windows PowerShell-Befehl Beschreibung
    Export-UevPackage MicrosoftCalculator6.pkgx Extrahiert die Einstellungen aus einer Microsoft Calculator-Paketdatei und konvertiert sie in ein lesbares Format in XML.
    Repair-UevTemplateIndex Repariert den Index der UE-V-Einstellungsspeicherortvorlagen.

So konfigurieren Sie den UE-V-Agent mithilfe von WMI

  1. User Experience Virtualization stellt die folgenden WMI-Befehle bereit. Administratoren können diese Schnittstelle verwenden, um den UE-V-Agent über die Befehlszeile zu konfigurieren und typische Konfigurationsaufgaben zu automatisieren.

    Verwenden Sie ein Konto mit Administratorrechten, um ein Windows PowerShell-Fenster zu öffnen.

  2. Verwenden Sie die folgenden WMI-Befehle, um den Agent zu konfigurieren.

    Windows PowerShell-Befehl Beschreibung
    Get-WmiObject -Namespace root\Microsoft\UEV Configuration Zeigt die aktiven UE-V-Agent-Einstellungen an. Benutzerspezifische Einstellungen haben Vorrang vor den Computereinstellungen.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration Zeigt die UE-V-Agent-Konfiguration an, die für einen Benutzer definiert ist.
    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration Zeigt die UE-V-Agent-Konfiguration an, die für einen Computer definiert ist.
    Get-WmiObject -Namespace root\Microsoft\Uev ConfigurationItem Zeigt die Details für jedes Konfigurationselement an.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SettingsStoragePath = <path_to_settings_storage_location>
    $config.Put()    		 Definiert einen Speicherort für computerspezifische Einstellungen.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration
    $config.SettingsStoragePath = <path_to_settings_storage_location>
    $config.Put()    		 Definiert einen Benutzereinstellungsspeicherort.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds>
    $config.Put()    		 Legt das Synchronisierungstimeout in Millisekunden für alle Benutzer des Computers fest.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.MaxPackageSizeInBytes = <size_in_bytes>
    $config.Put()    		 Konfiguriert den UE-V-Agent so, dass er meldet, wenn die Größe einer Einstellungspaketdatei einen definierten Schwellenwert erreicht. Legen Sie die Schwellenwertdateigröße des Pakets in Bytes für alle Benutzer des Computers fest.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SyncMethod = <sync_method>
    $config.Put()    		 Legt die Synchronisierungsmethode für alle Benutzer des Computers fest: SyncProvider oder None.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $true
    $config.Put()    		 Um eine bestimmte Computereinstellung zu aktivieren, löschen Sie die Einstellung, und verwenden Sie $null als Einstellungswert. Verwenden Sie UserConfiguration für Benutzereinstellungen.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $false
    $config.Put()    		 Um eine bestimmte Computereinstellung zu deaktivieren, löschen Sie die Einstellung, und verwenden Sie $null als Einstellungswert. Verwenden Sie die Benutzerkonfiguration für Benutzereinstellungen.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 Aktualisiert eine bestimmte Einstellung pro Computer. Um die Einstellung zu löschen, verwenden Sie $null als Einstellungswert.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 Aktualisiert eine bestimmte Benutzereinstellung für alle Benutzer des Computers. Um die Einstellung zu löschen, verwenden Sie $null als Einstellungswert.

Nach der Konfiguration des UE-V-Agents mit WMI und Windows PowerShell wird die definierte Konfiguration in der Registrierung an den folgenden Speicherorten gespeichert.

\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\UEV\Agent\Configuration

\HKEY_CURRENT_USER\SOFTWARE\Microsoft\UEV\Agent\Configuration

So exportieren Sie UE-V-Paketeinstellungen und reparieren UE-V-Vorlagen mithilfe von WMI

  1. UE-V stellt den folgenden Satz von WMI-Befehlen bereit. Administratoren können diese Schnittstelle verwenden, um ein Paket zu exportieren oder UE-V-Vorlagen zu reparieren.

  2. Verwenden Sie die folgenden WMI-Befehle.

    WMI-Befehl Beschreibung
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserSettings -Name ExportPackage -ArgumentList <package name> Extrahiert die Einstellungen aus einer Paketdatei und konvertiert sie in ein lesbares Format in XML.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name RebuildIndex Repariert den Index der UE-V-Einstellungsspeicherortvorlagen. Muss als Administrator ausgeführt werden.

Verwalten von UE-V 2.1 SP1 mit Windows PowerShell und WMI

Verwalten von UE-V 2.1 SP1