Verwalten von UE-V 2.x-Einstellungsspeicherortvorlagen mit Windows PowerShell und WMI
Letzte Aktualisierung: August 2015
Betrifft: User Experience Virtualization 2.0, User Experience Virtualization 2.1
Virtualisierung der Benutzerfreundlichkeit von Microsoft (UE-V) 2.0, 2.1 und 2.1 SP1 verwenden XML-Einstellungsspeicherortvorlagen, um die Einstellungen zu definieren, die Virtualisierung der Benutzerfreundlichkeit erfasst und anwendet. UE-V enthält eine Reihe von Standardvorlagen für Einstellungsspeicherorte. Darüber hinaus enthält die Lösung das UE-V Generator-Tool, mit dem Sie benutzerdefinierte Einstellungsspeicherortvorlagen erstellen können. Nach dem Erstellen und Bereitstellen von Einstellungsspeicherortvorlagen können Sie diese mithilfe von Windows PowerShell und der Windows-Verwaltungsinstrumentation (WMI) verwalten. Eine vollständige Liste der UE-V PowerShell-Cmdlets finden Sie unter UE-V 2-Cmdlet-Referenz (https://go.microsoft.com/fwlink/p/?LinkId=393495).
Verwalten von UE-V 2-Einstellungsspeicherortvorlagen mit Windows PowerShell
Mit WMI und den Windows PowerShell-Funktionen von UE-V können Sie Einstellungsspeicherortvorlagen aktivieren, deaktivieren, registrieren, aktualisieren und die Registrierung aufheben. Mithilfe dieser Funktionen können Sie den Prozess der Registrierung, Aktualisierung oder Aufhebung der Registrierung von Vorlagen mit dem UE-V-Agenten automatisieren. Sie können Vorlagen auch manuell über WMI und Windows PowerShell-Befehle registrieren. Wenn Sie diese Funktionen in Verbindung mit einer Lösung für die elektronische Softwareverteilung, einer Gruppenrichtlinie oder einer anderen automatisierten Bereitstellungsmethode wie ein Skript verwenden, können Sie diesen Prozess weiter automatisieren.
Sie benötigen Administratorrechte, um eine Einstellungsspeicherortvorlage aktualisieren, registrieren oder die Registrierung aufheben zu können. Für die Aktivierung, Deaktivierung und Auflistung von Vorlagen sind keine Administratorrechte erforderlich.
So verwalten Sie Einstellungsspeicherortvorlagen mit Windows PowerShell
Verwenden Sie ein Konto mit Administratorrechten, um eine Windows PowerShell-Eingabeaufforderung zu öffnen.
Verwenden Sie die folgenden Windows PowerShell-Cmdlets zum Registrieren und Verwalten der UE-V-Einstellungsspeicherortvorlagen.
Windows PowerShell-Befehl Beschreibung Get-UevTemplate
Listet alle Einstellungsspeicherortvorlagen auf, die auf dem Computer registriert sind.
Get-UevTemplate –Application <string>
Listet alle Einstellungsspeicherortvorlagen auf, die auf dem Computer registriert sind, bei denen der Anwendungs- oder Vorlagenname <string> enthält.
Get-UevTemplate –TemplateID <string>
Listet alle Einstellungsspeicherortvorlagen auf, die auf dem Computer registriert sind, bei denen die Vorlagen-ID <string> enthält.
Get-UevTemplate [-ApplicationOrTemplateID] <string>
Listet alle Einstellungsspeicherortvorlagen auf, die auf dem Computer registriert sind, bei denen der Anwendungs- oder Vorlagenname oder die Vorlagen-ID <string> enthält.
Get-UevTemplateProgram [-ID] <template ID>
Ruft den Namen des Programms und die Versionsinformationen ab, die von der Vorlagen-ID abhängig sind.
Get-UevAppXPackage
Ruft die effektive Liste von Windows-Apps ab.
Get-UevAppXPackage -Computer
Ruft die Liste der Windows-Apps ab, die für den Computer konfiguriert sind.
Get-UevAppXPackage -CurrentComputerUser
Ruft die Liste der Windows-Apps ab, die für den aktuellen Benutzer konfiguriert sind.
Register-UevTemplate [-Path] <template file path>[,<template file path>]
Registriert eine oder mehrere Einstellungsspeicherortvorlagen bei UE-V mithilfe von relativen Pfaden und/oder Platzhalterzeichen in Dateipfaden. Nach der Registrierung einer Vorlage synchronisiert UE-V die in der Vorlage definierten Einstellungen zwischen Computern, auf denen die Vorlage registriert ist.
Register-UevTemplate –LiteralPath <template file path>[,<template file path>]
Registriert eine oder mehrere Einstellungsspeicherortvorlagen bei UE-V mithilfe von literalen Pfaden, bei denen keine Zeichen als Platzhalterzeichen interpretiert werden können. Nach der Registrierung einer Vorlage synchronisiert UE-V die in der Vorlage definierten Einstellungen zwischen Computern, auf denen die Vorlage registriert ist.
Unregister-UevTemplate [-ID] <template ID>
Hebt die Registrierung einer Einstellungsspeicherortvorlage bei UE-V auf. Wenn die Registrierung einer Vorlage aufgehoben wird, werden die in der Vorlage definierten Einstellungen nicht mehr von UE-V zwischen Computern synchronisiert.
Unregister-UevTemplate -All
Hebt die Registrierung aller Einstellungsspeicherortvorlagen bei UE-V auf. Wenn die Registrierung einer Vorlage aufgehoben wird, werden die in der Vorlage definierten Einstellungen nicht mehr von UE-V zwischen Computern synchronisiert.
Update-UevTemplate [-Path] <template file path>[,<template file path>]
Aktualisiert eine oder mehrere Einstellungsspeicherortvorlagen mit einer neueren Version der Vorlage. Verwenden Sie relative Pfade und/oder Platzhalterzeichen in den Dateipfaden. Die neue Vorlage sollte eine neuere Version als die vorhandene Vorlage sein.
Update-UevTemplate –LiteralPath <template file path>[,<template file path>]
Aktualisiert eine oder mehrere Einstellungsspeicherortvorlagen mit einer neueren Version der Vorlage. Verwenden Sie vollständige Pfade zu Vorlagendateien, bei denen keine Zeichen als Platzhalterzeichen interpretiert werden können. Die neue Vorlage sollte eine neuere Version als die vorhandene Vorlage sein.
Clear-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]
Entfernt eine oder mehrere Windows-Apps aus der Liste der Windows-Apps auf dem Computer.
Clear-UevAppXPackage -CurrentComputerUser
Entfernt eine Windows-App aus der Liste der Windows-Apps des aktuellen Benutzers.
Clear-UevAppXPackage –Computer -All
Entfernt alle Windows-Apps aus der Liste der Windows-Apps auf dem Computer.
Clear-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]
Entfernt eine oder mehrere Windows-Apps aus der Liste der Windows-Apps des aktuellen Benutzers.
Clear-UevAppXPackage [–CurrentComputerUser] -All
Entfernt alle Windows-Apps aus der Liste der Windows-Apps des aktuellen Benutzers.
Disable-UevTemplate [-ID] <template ID>
Deaktiviert eine Einstellungsspeicherortvorlage für den aktuellen Benutzer des Computers.
Disable-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]
Deaktiviert eine oder mehrere Windows-Apps in der Liste der Windows-Apps auf dem Computer.
Disable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]
Deaktiviert eine oder mehrere Windows-Apps in der Liste der Windows-Apps des aktuellen Benutzers.
Enable-UevTemplate [-ID] <template ID>
Aktiviert eine Einstellungsspeicherortvorlage für den aktuellen Benutzer des Computers.
Enable-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]
Aktiviert eine oder mehrere Windows-Apps in der Liste der Windows-Apps auf dem Computer.
Enable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]
Aktiviert eine oder mehrere Windows-Apps in der Liste der Windows-Apps des aktuellen Benutzers.
Test-UevTemplate [-Path] <template file path>[,<template file path>]
Bestimmt, ob eine oder mehrere Einstellungsspeicherortvorlagen mit einem XML-Schema übereinstimmen. Sie können relative Pfade und Platzhalterzeichen verwenden.
Test-UevTemplate –LiteralPath <template file path>[,<template file path>]
Bestimmt, ob eine oder mehrere Einstellungsspeicherortvorlagen mit einem XML-Schema übereinstimmen. Der Pfad muss ein vollständiger Pfad zu der Vorlagendatei sein, enthält jedoch keine Platzhalterzeichen.
Mit den UE-V Windows PowerShell-Funktionen können Sie eine Gruppe von Einstellungsvorlagen verwalten, die in Ihrem Unternehmen bereitgestellt werden. Gehen Sie wie folgt vor, um eine Gruppe von Vorlagen mit Windows PowerShell zu verwalten.
So verwalten Sie eine Gruppe von Einstellungsspeicherortvorlagen mit Windows PowerShell
Ändern oder aktualisieren Sie die gewünschten Einstellungsspeicherortvorlagen.
Wenn Sie die Einstellungsspeicherortvorlagen ändern oder aktualisieren möchten, stellen Sie diese Einstellungsspeicherortvorlagen in einem Ordner bereit, auf den der lokale Computer zugreifen kann.
Öffnen Sie auf dem lokalen Computer ein Windows PowerShell-Fenster mit Administratorrechten.
Heben die Registrierung aller zuvor registrierten Versionen der Vorlagen durch Eingabe des folgenden Befehls auf.
Unregister-UevTemplate -All
Dieser Befehl hebt die Registrierung aller aktiven Vorlagen auf dem Computer auf.
Registrieren Sie die aktualisierten Vorlagen, indem Sie den folgenden Befehl eingeben.
Register-UevTemplate <path to template folder>\*.xml
Dieser Befehl registriert alle Einstellungsspeicherortvorlagen, die sich in dem angegebenen Vorlagenordner befinden.
Liste der Windows-Apps
Durch das Einfügen einer Windows-App in die Liste der Windows-Apps legen Sie fest, ob deren Einstellungen synchronisiert werden sollen. Apps werden in der Liste nach Paketfamiliennamen identifiziert, zudem gibt die Liste an, ob eine Synchronisierung der Einstellungen stattfinden soll. Mithilfe dieser Einstellungen in Kombination mit der Einstellung „Synchronisierung nicht aufgelisteter Windows-Apps“ können Sie steuern, ob Windows-Apps synchronisiert werden.
Geben Sie zum Anzeigen des Paketfamiliennamens installierter Windows-Apps an einer Windows PowerShell-Eingabeaufforderung Folgendes ein:
Get-AppxPackage | Sort-Object PackageFamilyName | Format-Table PackageFamilyName
Geben Sie zum Anzeigen einer Liste der Paketfamiliennamen von Windows-Apps auf einem Computer, deren Einstellungen synchronisiert werden können, sowie deren Aktivierungsstatus und -quelle an einer Windows PowerShell-Eingabeaufforderung Folgendes ein: Get-UevAppxPackage
Definitionen von Get-UevAppxPackage-Eigenschaften
- DisplayName
Name, der im Unternehmenseinstellungscenter angezeigt wird. DieDisplayName
-Eigenschaft wird von derPackageFamilyName
-Eigenschaft abgeleitet.
- PackageFamilyName
Name des Pakets, das für den aktuellen Benutzer installiert ist.
- Aktiviert
Gibt an, ob Einstellungen der App zur Synchronisierung konfiguriert sind.
- EnabledSource
Ort, an dem die Konfiguration zur Aktivierung bzw. Deaktivierung der App festgelegt ist. Mögliche Werte: NotSet, LocalMachine, LocalUser, PolicyMachine und PolicyUser.
- NotSet
Die Richtlinie ist nicht für die Synchronisierung der App konfiguriert.
- LocalMachine
Der Aktivierungsstatus ist im Abschnitt zum lokalen Computer der Registrierung festgelegt.
- LocalUser
Der Aktivierungsstatus ist im Abschnitt zum aktuellen Benutzer der Registrierung festgelegt.
- PolicyMachine
Der Aktivierungsstatus ist im Abschnitt zu den Richtlinien des lokalen Computers in der Registrierung festgelegt.
Geben Sie zum Anzeigen der benutzerdefinierten Liste der Windows-Apps an einer Windows PowerShell-Eingabeaufforderung Folgendes ein: Get-UevAppxPackage –CurrentComputerUser
Geben Sie zum Anzeigen der vom Computer konfigurierten Liste der Windows-Apps an einer Windows PowerShell-Eingabeaufforderung Folgendes ein: Get-UevAppxPackage –Computer
Das Cmdlet gibt für den Parameter „CurrentComputerUser“ bzw. für den Parameter „Computer“ eine Liste der Windows-Apps zurück, die auf Benutzer- bzw. Computerebene konfiguriert wurden.
Definition der Eigenschaften
- DisplayName
Name, der im Unternehmenseinstellungscenter angezeigt wird. DieDisplayName
-Eigenschaft wird von derPackageFamilyName
-Eigenschaft abgeleitet.
- PackageFamilyName
Name des Pakets, das für den aktuellen Benutzer installiert ist.
- Aktiviert
Gibt an, ob Einstellungen der App zur Synchronisierung für den angegebenen Schalter (user oder computer) konfiguriert sind.
- Installed
„True“, wenn die App, d. h. PackageFamilyName, für den aktuellen Benutzer installiert ist.
Verwalten von UE-V 2-Einstellungsspeicherortvorlagen mit WMI
Virtualisierung der Benutzerfreundlichkeit bietet den folgenden Satz von WMI-Befehlen. Administratoren können diese Schnittstellen verwenden, um Einstellungsspeicherortvorlagen von Windows PowerShell zu verwalten und Verwaltungsaufgaben für Vorlagen zu automatisieren.
So verwalten Sie Einstellungsspeicherortvorlagen mit WMI
Verwenden Sie ein Konto mit Administratorrechten, um ein Windows PowerShell-Fenster zu öffnen.
Verwenden Sie die folgenden WMI-Befehle zum Registrieren und Verwalten der UE-V-Einstellungsspeicherortvorlagen.
Windows PowerShell command
Beschreibung Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate | Select-Object TemplateId,TemplateName, TemplateVersion,Enabled | Format-Table -Autosize
Listet alle Einstellungsspeicherortvorlagen auf, die für den Computer registriert sind.
Invoke-WmiMethod –Namespace root\Microsoft\UEV –Class SettingsLocationTemplate –Name GetProcessInfoByTemplateId <template Id>
Ruft den Namen des Programms und die Versionsinformationen ab, die vom Vorlagennamen abhängig sind.
Get-WmiObject -Namespace root\Microsoft\UEV EffectiveWindows8App
Ruft die effektive Liste von Windows-Apps ab.
Get-WmiObject -Namespace root\Microsoft\UEV MachineConfiguredWindows8App
Ruft die Liste der Windows-Apps ab, die für den Computer konfiguriert sind.
Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguredWindows8App
Ruft die Liste der Windows-Apps ab, die für den aktuellen Benutzer konfiguriert sind.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Register -ArgumentList <template path >
Registriert eine Einstellungsspeicherortvorlage bei UE-V.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name UnregisterByTemplateId -ArgumentList <template ID>
Hebt die Registrierung einer Einstellungsspeicherortvorlage bei UE-V auf. Sobald die Registrierung einer Vorlage aufgehoben wird, werden die in der Vorlage definierten Einstellungen nicht mehr von UE-V zwischen Computern synchronisiert.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList <template path>
Aktualisiert eine Einstellungsspeicherortvorlage mit UE-V. Die neue Vorlage sollte eine neuere Version als die vorhandene sein.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name | package family name>
Entfernt eine oder mehrere Windows-Apps aus der Liste der Windows-Apps auf dem Computer.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name | package family name>
Entfernt eine oder mehrere Windows-Apps aus der Liste der Windows-Apps des aktuellen Benutzers.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name DisableByTemplateId -ArgumentList <template ID>
Deaktiviert eine oder mehrere Einstellungsspeicherortvorlagen mit UE-V.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name DisableApp -ArgumentList <package family name | package family name>
Deaktiviert eine oder mehrere Windows-Apps in der Liste der Windows-Apps auf dem Computer.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name DisableApp -ArgumentList <package family name | package family name>
Deaktiviert eine oder mehrere Windows-Apps in der Liste der Windows-Apps des aktuellen Benutzers.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name EnableByTemplateId -ArgumentList <template ID>
Aktiviert eine Einstellungsspeicherortvorlage mit UE-V.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name EnableApp -ArgumentList <package family name | package family name>
Aktiviert Windows-Apps in der Liste der Windows-Apps auf dem Computer.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <package family name | package family name>
Aktiviert Windows-Apps in der Liste der Windows-Apps des aktuellen Benutzers.
Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList <template path>
Bestimmt, ob eine bestimmte Einstellungsspeicherortvorlage mit einem XML-Schema übereinstimmt.
Hinweis
Wenn eine Liste von Paketfamiliennamen von dem WMI-Befehl aufgerufen wird, muss die Liste in Anführungszeichen eingeschlossen und durch ein Pipezeichen getrennt werden, z. B.
"<package family name | package family name>"
.
Bereitstellen des UE-V-Agenten mit Windows PowerShell
So stellen Sie den UE-V-Agent mithilfe von Windows PowerShell bereit
Stellen Sie das Installationspaket für den UE-V-Agenten 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. Die Windows Installer-Pakete, AgentSetupx86.msi und AgentSetupx64.msi, stehen für jede Architektur zur Verfügung. Zur späteren Deinstallation des UE-V-Agenten mithilfe der Installationsdatei müssen Sie denselben Dateityp verwenden.
Verwenden Sie einen der folgenden Windows PowerShell-Befehle, um den UE-V-Agenten zu installieren.
& 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%
Haben Sie einen Vorschlag für UE-V? Fügen Sie hier Vorschläge hinzu, oder stimmen Sie über Vorschläge ab.
Haben Sie Probleme mit UE-V? Nutzen Sie das UE-V-TechNet-Forum.
Siehe auch
Weitere Ressourcen
Verwalten von UE-V 2.x mit Windows PowerShell und WMI
Verwalten von UE-V 2.x