Freigeben über

Verwalten des UE-V 1.0-Agenten und von Paketen mit PowerShell und WMI

  • Artikel

Letzte Aktualisierung: April 2013

Betrifft: User Experience Virtualization 1.0

Sie können mit WMI und PowerShell die Konfiguration des Microsoft User Experience Virtualization (UE-V)-Agenten und das Synchronisierungsverhalten verwalten.

Bereitstellen des UE-V-Agenten mit PowerShell

  1. Stellen Sie die UE-V-Installer-Datei in einer zugänglichen Netzwerkfreigabe bereit.

    Hinweis

    Verwenden Sie AgentSetup.exe, um sowohl 32-Bit- als auch 64-Bit-Versionen des UE-V-Agenten bereitzustellen. Für jede Architektur stehen Versionen der Windows Installer-Dateien, AgentSetupx86.msi und AgentSetupx64.msi, zur Verfügung. Zur späteren Deinstallation des UE-V-Agenten mithilfe der Installationsdatei müssen Sie denselben Dateityp verwenden.

  2. Verwenden Sie einen der folgenden PowerShell-Befehle zur Agenteninstallation.

    & 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-Agenten mit PowerShell

  1. Verwenden Sie ein Konto mit Administratorrechten, um ein PowerShell-Fenster zu öffnen. Importieren Sie das UE-V-PowerShell-Modul mithilfe des folgenden Befehls.

    Import-module UEV

  2. Konfigurieren Sie mithilfe folgender PowerShell-Befehle den Agenten.

    PowerShell-Befehl

    Beschreibung

    Get-UevConfiguration

    Anzeigen der aktuellen Einstellungen für den UE-V-Agenten. Benutzerspezifische Einstellungen haben Vorrang vor den Computereinstellungen.

    Get-UevConfiguration -CurrentComputerUser

    Anzeigen der Einstellungswerte für den UE-V-Agenten nur für den aktuellen Benutzer.

    Get-UevConfiguration -Computer

    Anzeigen der Konfigurationseinstellungswerte für den UE-V-Agenten für alle Benutzer auf dem Computer.

    Set-UevConfiguration -Computer -SettingsStoragePath <Pfad_zum_Einstellungsspeicherort>

    Definieren eines computerspezifischen Einstellungsspeicherorts.

    Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <Pfad_zum_Einstellungsspeicherort>

    Definieren eines benutzerspezifischen Einstellungsspeicherorts.

    Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <Timeout in Millisekunden>

    Festlegen des Synchronisierungstimeouts in Millisekunden.

    Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <Timeout in Millisekunden>

    Festlegen des Synchronisierungstimeouts für den aktuellen Benutzer.

    Set-UevConfiguration -Computer -MaxPackageSizeInBytes <Größe in Byte>

    Konfigurieren des UE-V-Agenten für die Ausgabe einer Meldung, wenn die Dateigröße eines Einstellungspakets einen festgelegten Schwellenwert erreicht. Legen Sie den Schwellenwert für die Paketgröße in Byte fest.

    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <Größe in Byte>

    Festlegen des Warnungsschwellenwerts für die Paketgröße für den aktuellen Benutzer.

    Set-UevConfiguration –Computer –SettingsTemplateCatalogPath <Pfad zum Katalog>

    Festlegen des Pfads zum Einstellungsvorlagenkatalog.

    Set-UevConfiguration -Computer -SyncMethod <Synchronisierungsmethode>

    Festlegen der Synchronisierungsmethode: „OfflineFiles“ oder „None“.

    Set-UevConfiguration -CurrentComputerUser -SyncMethod <Synchronisierungsmethode>

    Festlegen der Synchronisierungsmethode für den aktuellen Benutzer. „OfflineFiles“ oder „None“.

    Set-UEVConfiguration -Computer –EnableSettingsImportNotify

    Aktivieren der Benachrichtigung, die bei einer Verzögerung beim Import von Benutzereinstellungen ausgegeben wird.

    Verwenden Sie –DisableSettingsImportNotify, um die Benachrichtigung deaktivieren.

    Set-UEVConfiguration - CurrentComputerUser -EnableSettingsImportNotify

    Aktivieren der Benachrichtigung für den aktuellen Benutzer, die bei einer Verzögerung beim Import von Benutzereinstellungen ausgegeben wird.

    Verwenden Sie –DisableSettingsImportNotify, um die Benachrichtigung deaktivieren.

    Set-UEVConfiguration -Computer -SettingsImportNotifyDelayInSeconds

    Angabe der Zeit in Sekunden, bevor der Benutzer informiert wird.

    Set-UEVConfiguration - CurrentComputerUser -SettingsImportNotifyDelayInSeconds

    Angabe der Zeit in Sekunden, bevor der aktuelle Benutzer informiert wird.

    Set-UevConfiguration –Computer –DisableSync

    Deaktivieren von UE-V für alle Benutzer auf dem Computer.

    Verwenden Sie –EnableSync zum Aktivieren oder erneuten Aktivieren.

    Set-UevConfiguration –CurrentComputerUser -DisableSync

    Deaktivieren von UE-V für den aktuellen Benutzer auf dem Computer.

    Verwenden Sie –EnableSync zum Aktivieren oder erneuten Aktivieren.

    Clear-UevConfiguration –Computer -<Einstellungsname>

    Löschen einer bestimmten Einstellung für alle Benutzer auf dem Computer.

    Clear-UevConfiguration –CurrentComputerUser -<Einstellungsname>

    Löschen einer bestimmten Einstellung nur für den aktuellen Benutzer.

    Export-UevConfiguration <Einstellungsmigrationsdatei>

    Exportieren der UE-V-Computerkonfiguration in eine Einstellungsmigrationsdatei. Die Erweiterung der Datei muss „.uev“ sein.

    Das Export-Cmdlet exportiert alle Einstellungen des UE-V-Agenten, die mit dem Parameter -computer konfiguriert werden können.

    Import-UevConfiguration <Einstellungsmigrationsdatei>

    Importieren der UE-V-Computerkonfiguration aus einer Einstellungsmigrationsdatei (.uev-Datei).

Exportieren von UE-V-Paketeinstellungen und Reparieren von UE-V-Vorlagen mit PowerShell

  1. Öffnen Sie als Administrator ein PowerShell-Fenster. Importieren Sie das UE-V-PowerShell-Modul mithilfe des folgenden Befehls.

    Import-module UEV

  2. Konfigurieren Sie mithilfe folgender PowerShell-Befehle den Agenten.

    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-Einstellungsortvorlagen.

So konfigurieren Sie den UE-V-Agenten mit WMI

  1. Virtualisierung der Benutzerfreundlichkeit bietet den folgenden Satz von WMI-Befehlen. Administratoren können mithilfe dieser Schnittstelle den UE-V-Agenten über die Befehlszeile konfigurieren und typische Konfigurationsaufgaben automatisieren.

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

  2. Konfigurieren Sie mithilfe folgender WMI-Befehle den Agenten.

    PowerShell-Befehl Beschreibung

    Get-WmiObject -Namespace root\Microsoft\UEV Configuration

    Anzeigen der aktiven Einstellungen für den UE-V-Agenten. Benutzerspezifische Einstellungen haben Vorrang vor den Computereinstellungen.

    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    Anzeigen der für den Benutzer definierten Konfiguration des UE-V-Agenten.

    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    Anzeigen der für den Computer definierten Konfiguration des UE-V-Agenten.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SettingsStoragePath = <Pfad_zum_Einstellungsspeicherort>

    $config.Put()

    Definieren eines computerspezifischen Einstellungsspeicherorts.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    $config.SettingsStoragePath = <Pfad_zum_Einstellungsspeicherort>

    $config.Put()

    Definieren eines benutzerspezifischen Einstellungsspeicherorts.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SyncTimeoutInMilliseconds = <Timeout_in_Millisekunden>

    $config.Put()

    Festlegen des Synchronisierungstimeouts in Millisekunden.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.MaxPackageSizeInBytes = <Größe_in_Byte>

    $config.Put()

    Konfigurieren des UE-V-Agenten für die Ausgabe einer Meldung, wenn die Dateigröße eines Einstellungspakets einen festgelegten Schwellenwert erreicht. Legen Sie den Schwellenwert für die Paketdateigröße in Byte fest.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SyncMethod = <Synchronisierungsmethode>

    $config.Put()

    Festlegen der Synchronisierungsmethode: „OfflineFiles“ oder „None“.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<Einstellungsname> = <Einstellungswert>

    $config.Put()

    Aktualisiert eine bestimmte computerspezifische Einstellung. Verwenden Sie zum Löschen der Einstellung $Null als Einstellungswert.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<Einstellungsname> = <Einstellungswert>

    $config.Put()

    Aktualisiert eine bestimmte benutzerspezifische Einstellung. Verwenden Sie zum Löschen der Einstellung $Null als Einstellungswert.

    Nach der Konfiguration des UE-V-Agenten mit WMI und PowerShell wird die festgelegte Konfiguration an folgenden Orten in der Registrierung gespeichert:

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

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

Siehe auch

Andere Ressourcen

Verwalten von UE-V 1.0
Vorgänge für UE-V 1.0

-----
Weitere Informationen zu MDOP finden Sie in der TechNet-Bibliothek. Sie können auch im TechNet Wiki nach Problembehandlungen suchen und uns auf Facebook oder Twitter folgen.
-----