Freigeben über

Verwalten des UE-V-Diensts und der Pakete mit Windows PowerShell und WMI (Windows 10)

  • Artikel

Sie können die Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) und Windows PowerShell verwenden, um die Konfiguration und das Synchronisierungsverhalten des UE-V-Diensts (User Experience Virtualization) zu verwalten.

Hinweis

Eine vollständige Liste der UE-V-Cmdlets finden Sie unter User Experience Virtualization in Windows PowerShell.

So konfigurieren Sie den UE-V-Dienst mit 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 Dienst zu konfigurieren.

    Windows PowerShell-Befehl Beschreibung
    Enable-UEV Aktiviert den UE-V-Dienst. Erfordert einen Neustart.
    Disable-UEV Deaktiviert den UE-V-Dienst. Erfordert einen Neustart.
    Get-UevStatus Zeigt unter Verwendung eines booleschen Werts an, ob der UE-V-Dienst aktiviert oder deaktiviert ist.
    Get-UevConfiguration Ruft die effektiven UE-V-Diensteinstellungen ab. Benutzerspezifische Einstellungen haben Vorrang vor den Computereinstellungen.
    Get-UevConfiguration -CurrentComputerUser Ruft nur die UE-V-Diensteinstellungen für den aktuellen Benutzer ab.
    Get-UevConfiguration -Computer Ruft die Konfigurationseinstellungen des UE-V-Diensts 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 -EnableDontSyncWindows8AppSettings Konfiguriert den UE-V-Dienst so, dass keine Windows-Apps für alle Benutzer auf dem Computer synchronisiert werden.
    Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings Konfiguriert den UE-V-Dienst so, dass keine Windows-Apps für den aktuellen Computerbenutzer synchronisiert werden.
    Set-UevConfiguration -Computer -EnableFirstUseNotification Konfiguriert den UE-V-Dienst so, dass Benachrichtigungen angezeigt werden, wenn der Dienst zum ersten Mal für alle Benutzer auf dem Computer ausgeführt wird.
    Set-UevConfiguration -Computer -DisableFirstUseNotification Konfiguriert den UE-V-Dienst so, dass keine Benachrichtigung angezeigt wird, wenn der Dienst zum ersten Mal für alle Benutzer auf dem Computer ausgeführt wird.
    Set-UevConfiguration -Computer -EnableSettingsImportNotify Konfiguriert den UE-V-Dienst 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-Dienst so, dass der aktuelle Benutzer benachrichtigt wird, 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-Dienst so, dass alle Windows-Apps synchronisiert werden, die nicht explizit von der Windows-App-Liste für alle Benutzer des Computers deaktiviert werden. Weitere Informationen finden Sie unter "Get-UevAppxPackage" unter Verwalten von Standortvorlagen für UE-V-Einstellungen mithilfe von Windows PowerShell und WMI.

    Verwenden Sie den Parameter DisableSyncUnlistedWindows8Apps, um den UE-V-Dienst 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-Dienst so, dass alle Windows-Apps synchronisiert werden, die nicht explizit von der Windows-App-Liste für den aktuellen Benutzer auf dem Computer deaktiviert werden. Weitere Informationen finden Sie unter "Get-UevAppxPackage" unter Verwalten von Standortvorlagen für UE-V-Einstellungen mithilfe von Windows PowerShell und WMI.

    Verwenden Sie den Parameter DisableSyncUnlistedWindows8Apps, um den UE-V-Dienst 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-Dienst 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-Dienst 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> Legen Sie 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 .uev sein.

    Das Export Cmdlet exportiert alle UE-V-Diensteinstellungen, 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 .uev sein.

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

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

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

    Windows PowerShell-Befehl Beschreibung
    Export-UevPackage MicrosoftNotepad.pkgx Extrahiert die Einstellungen aus einer Microsoft Editor-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-Dienst mit WMI

  1. User Experience Virtualization stellt die folgenden WMI-Befehle bereit. Administratoren können diese Schnittstelle verwenden, um den UE-V-Dienst ü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 Dienst zu konfigurieren.

    Windows PowerShell command Beschreibung
    Get-WmiObject -Namespace root\Microsoft\UEV Configuration Zeigt die aktiven UE-V-Diensteinstellungen an. Benutzerspezifische Einstellungen haben Vorrang vor den Computereinstellungen.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration Zeigt die UE-V-Dienstkonfiguration an, die für einen Benutzer definiert ist.
    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration Zeigt die UE-V-Dienstkonfiguration 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-Dienst so, dass er meldet, wenn die Dateigröße eines Einstellungspakets 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()

    		 Updates 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()

    		 Updates eine bestimmte Benutzereinstellung für alle Benutzer des Computers. Um die Einstellung zu löschen, verwenden Sie $null als Einstellungswert.

Wenn Sie die Konfiguration des UE-V-Diensts mit WMI und Windows PowerShell abgeschlossen haben, 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 mit Windows PowerShell und WMIVerwalten der UE-V-Benutzerfreundlichkeitsvirtualisierungin Windows PowerShell