Verwalten von UE-V 2.x-Einstellungsspeicherortvorlagen mithilfe von Windows PowerShell und WMI

Microsoft User Experience Virtualization (UE-V) 2.0, 2.1 und 2.1 SP1 verwenden XML-Einstellungsspeicherortvorlagen, um die Einstellungen zu definieren, die user Experience Virtualization erfasst und anwendet. UE-V enthält eine Reihe von Standardeinstellungsspeicherortvorlagen. Es enthält auch das UE-V-Generator-Tool, mit dem Sie benutzerdefinierte Einstellungsspeicherortvorlagen erstellen können. Nachdem Sie Positionsvorlagen für Einstellungen erstellt und bereitgestellt haben, können Sie diese Vorlagen 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 Reference (https://go.microsoft.com/fwlink/p/?LinkId=393495).

Verwalten von UE-V 2-Einstellungsspeicherortvorlagen mithilfe von Windows PowerShell

Die WMI- und Windows PowerShell-Features von UE-V umfassen die Möglichkeit zum Aktivieren, Deaktivieren, Registrieren, Aktualisieren und Aufheben der Registrierung von Einstellungsspeicherortvorlagen. Mithilfe dieser Features können Sie das Registrieren, Aktualisieren oder Aufheben der Registrierung von Vorlagen beim UE-V-Agent automatisieren. Sie können Vorlagen auch manuell mithilfe von WMI und Windows PowerShell-Befehlen registrieren. Wenn Sie diese Features in Verbindung mit einer elektronischen Softwareverteilungslösung, Gruppenrichtlinie oder einer anderen automatisierten Bereitstellungsmethode wie einem Skript verwenden, können Sie diesen Prozess weiter automatisieren.

Sie müssen über Administratorberechtigungen zum Aktualisieren, Registrieren oder Aufheben der Registrierung einer Einstellungsspeicherortvorlage verfügen. Administratorberechtigungen sind nicht erforderlich, um Vorlagen zu aktivieren, zu deaktivieren oder auflisten zu können.

So verwalten Sie Speicherortvorlagen für Einstellungen mithilfe von Windows PowerShell

1. Verwenden Sie ein Konto mit Administratorrechten, um eine Windows PowerShell Eingabeaufforderung zu öffnen.

2. Verwenden Sie die folgenden Windows PowerShell Cmdlets, um die UE-V-Einstellungsspeicherortvorlagen zu registrieren und zu verwalten.

   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, auf dem der Anwendungsname oder Vorlagenname eine Zeichenfolge> enthält<.
   Get-UevTemplate –TemplateID <string>	Listet alle Einstellungsspeicherortvorlagen auf, die auf dem Computer registriert sind, auf dem die Vorlagen-ID eine Zeichenfolge> enthält<.
   Get-UevTemplate [-ApplicationOrTemplateID] <string>	Listet alle Einstellungsspeicherortvorlagen auf, die auf dem Computer registriert sind, auf dem der Anwendungs- oder Vorlagenname oder die Vorlagen-ID Zeichenfolge> enthält<.
   Get-UevTemplateProgram [-ID] <template ID>	Ruft den Namen des Programms und die Versionsinformationen ab, die von der Vorlagen-ID abhängen.
   Get-UevAppXPackage	Ruft die effektive Liste der 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 relativer Pfade und/oder Platzhalterzeichen in Dateipfaden. Nachdem eine Vorlage registriert wurde, 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 Literalpfaden, in denen keine Zeichen als Platzhalterzeichen interpretiert werden können. Nachdem eine Vorlage registriert wurde, 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 mit UE-V auf. Wenn eine Vorlage nicht registriert ist, synchronisiert UE-V die einstellungen, die in der Vorlage definiert sind, nicht mehr zwischen Computern.
   Unregister-UevTemplate -All	Hebt die Registrierung aller Einstellungsspeicherortvorlagen mit UE-V auf. Wenn eine Vorlage nicht registriert ist, synchronisiert UE-V die einstellungen, die in der Vorlage definiert sind, nicht mehr zwischen Computern.
   Update-UevTemplate [-Path] <template file path>[,<template file path>]	Aktualisierungen 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>]	Aktualisierungen eine oder mehrere Einstellungsspeicherortvorlagen mit einer neueren Version der Vorlage. Verwenden Sie vollständige Pfade für Vorlagendateien, in 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 Windows-App-Liste des Computers.
   Clear-UevAppXPackage -CurrentComputerUser	Entfernt die Windows-App aus der Windows-App-Liste des aktuellen Benutzers.
   Clear-UevAppXPackage –Computer -All	Entfernt alle Windows-Apps aus der Windows-App-Liste des Computers.
   Clear-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]	Entfernt eine oder mehrere Windows-Apps aus der Windows-App-Liste des aktuellen Benutzers.
   Clear-UevAppXPackage [–CurrentComputerUser] -All	Entfernt alle Windows-Apps aus der aktuellen Windows-App-Benutzerliste.
   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 Windows-App-Liste des Computers.
   Disable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]	Deaktiviert eine oder mehrere Windows-Apps in der Windows-App-Liste 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 Windows-App-Liste des Computers.
   Enable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]	Aktiviert eine oder mehrere Windows-Apps in der Windows-App-Liste des aktuellen Benutzers.
   Test-UevTemplate [-Path] <template file path>[,<template file path>]	Bestimmt, ob eine oder mehrere Einstellungsspeicherortvorlagen dem XML-Schema entsprechen. Kann relative Pfade und Platzhalterzeichen verwenden.
   Test-UevTemplate –LiteralPath <template file path>[,<template file path>]	Bestimmt, ob eine oder mehrere Einstellungsspeicherortvorlagen dem XML-Schema entsprechen. Der Pfad muss ein vollständiger Pfad zur Vorlagendatei sein, enthält jedoch keine Platzhalterzeichen.

Mit den UE-V-Windows PowerShell-Features können Sie eine Gruppe von Einstellungsvorlagen verwalten, die in Ihrem Unternehmen bereitgestellt werden. Verwenden Sie das folgende Verfahren, um eine Gruppe von Vorlagen mithilfe von Windows PowerShell zu verwalten.

So verwalten Sie eine Gruppe von Einstellungsspeicherortvorlagen mithilfe von Windows PowerShell

1. Ändern oder aktualisieren Sie die gewünschten Einstellungsspeicherortvorlagen.

2. Wenn Sie die Einstellungsspeicherortvorlagen ändern oder aktualisieren möchten, stellen Sie diese Einstellungsspeicherortvorlagen in einem Ordner bereit, auf den der lokale Computer zugreifen kann.

3. Öffnen Sie auf dem lokalen Computer ein Windows PowerShell Fenster mit Administratorrechten.

4. Heben Sie die Registrierung aller zuvor registrierten Versionen der Vorlagen auf, indem Sie den folgenden Befehl eingeben.

   Unregister-UevTemplate -All
   

   Mit diesem Befehl wird die Registrierung aller aktiven Vorlagen auf dem Computer aufgehoben.

5. Registrieren Sie die aktualisierten Vorlagen, indem Sie den folgenden Befehl eingeben.

   Register-UevTemplate <path to template folder>\*.xml
   

   Mit diesem Befehl werden alle Einstellungsspeicherortvorlagen registriert, die sich im angegebenen Vorlagenordner befinden.

Windows-App-Liste

Indem Sie eine Windows-App in der Windows-App-Liste auflisten, geben Sie an, ob diese App für die Einstellungssynchronisierung aktiviert oder deaktiviert ist. Apps werden in der Liste anhand ihres Paketfamiliennamens identifiziert und geben an, ob die Einstellungssynchronisierung für diese App aktiviert oder deaktiviert werden soll. Wenn Sie diese Einstellungen zusammen mit der Einstellung "Nicht aufgelistetes Standardsynchronisierungsverhalten" verwenden, können Sie steuern, ob Windows-Apps synchronisiert werden.

Um den Paketfamiliennamen der installierten Windows-Apps anzuzeigen, geben Sie an einer Windows PowerShell Eingabeaufforderung Folgendes ein:

Get-AppxPackage | Sort-Object PackageFamilyName | Format-Table PackageFamilyName

Wenn Sie eine Liste von Windows-Apps anzeigen möchten, die Einstellungen auf einem Computer mit dem Paketfamiliennamen, dem aktivierten Status und der aktivierten Quelle synchronisieren können, geben Sie an einer Windows PowerShell Eingabeaufforderung Folgendes ein:Get-UevAppxPackage

Definitionen Get-UevAppxPackage Eigenschaften

Displayname
Der Name, der dem Benutzer in der Unternehmenseinstellungen-Center-Anwendung angezeigt wird. Die DisplayName Eigenschaft wird von der PackageFamilyName Eigenschaft abgeleitet.

PackageFamilyName
Der Name des Pakets, das für den aktuellen Benutzer installiert ist.

Aktiviert
Definiert, ob die Einstellungen für die App für die Synchronisierung konfiguriert sind.

EnabledSource
Der Speicherort, an dem die Konfiguration, die die App aktiviert oder deaktiviert, festgelegt ist. Mögliche Werte sind: NotSet, LocalMachine, LocalUser, PolicyMachine und PolicyUser.

Notset
Die Richtlinie ist nicht für die Synchronisierung dieser App konfiguriert.

Localmachine
Der Aktiviert-Zustand wird im Abschnitt "Lokaler Computer" der Registrierung festgelegt.

LocalUser
Der aktivierte Status wird im aktuellen Benutzerabschnitt der Registrierung festgelegt.

PolicyMachine
Der Aktiviert-Zustand wird im Richtlinienabschnitt des Abschnitts "Lokaler Computer" der Registrierung festgelegt.

Um die vom Benutzer konfigurierte Liste der Windows-Apps abzurufen, geben Sie an der Windows PowerShell Eingabeaufforderung Folgendes ein:Get-UevAppxPackage –CurrentComputerUser

Um die computerkonfigurierte Liste der Windows-Apps abzurufen, geben Sie an der Windows PowerShell Eingabeaufforderung Folgendes ein:Get-UevAppxPackage –Computer

Für Parameter, CurrentComputerUser oder Computer gibt das Cmdlet eine Liste der Windows-Apps zurück, die auf Benutzer- oder Computerebene konfiguriert sind.

Definitionen von Eigenschaften

Displayname
Der Name, der dem Benutzer in der Unternehmenseinstellungen-Center-Anwendung angezeigt wird. Die DisplayName Eigenschaft wird von der PackageFamilyName Eigenschaft abgeleitet.

PackageFamilyName
Der Name des Pakets, das für den aktuellen Benutzer installiert ist.

Aktiviert
Definiert, ob die Einstellungen für die App für die Synchronisierung für den angegebenen Switch konfiguriert sind, d. h. Benutzer oder Computer.

Installiert
True, wenn die App, d. h. der PackageFamilyName, für den aktuellen Benutzer installiert ist.

Verwalten von UE-V 2-Einstellungsspeicherortvorlagen mithilfe von WMI

User Experience Virtualization bietet die folgenden WMI-Befehle. Administratoren können diese Schnittstellen verwenden, um Einstellungsspeicherortvorlagen aus Windows PowerShell zu verwalten und administrative Aufgaben für Vorlagen zu automatisieren.

So verwalten Sie Einstellungsspeicherortvorlagen mithilfe von WMI

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

2. Verwenden Sie die folgenden WMI-Befehle, um die UE-V-Einstellungsspeicherortvorlagen zu registrieren und zu verwalten.

   Windows PowerShell command	Beschreibung
   Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate | Select-Object TemplateId,TemplateName, TemplateVersion,Enabled | Format-Table -Autosize	Listet alle Für den Computer registrierten Einstellungsspeicherortvorlagen auf.
   Invoke-WmiMethod –Namespace root\Microsoft\UEV –Class SettingsLocationTemplate –Name GetProcessInfoByTemplateId <template Id>	Ruft den Namen des Programms und der Versionsinformationen ab, die vom Vorlagennamen abhängig sind.
   Get-WmiObject -Namespace root\Microsoft\UEV EffectiveWindows8App	Ruft die effektive Liste der 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 mit UE-V auf. Sobald die Registrierung einer Vorlage aufgehoben wird, synchronisiert UE-V die in der Vorlage definierten Einstellungen nicht mehr zwischen Computern.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList <template path>	Aktualisierungen einer Einstellungsspeicherortvorlage mit UE-V. Die neue Vorlage sollte eine neuere Version sein als die vorhandene.
   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 Windows-App-Liste des Computers.
   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 Windows-App-Liste 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 Windows-App-Liste des Computers.
   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 Windows-App-Liste 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 Windows-App-Liste des Computers.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <package family name | package family name>	Aktiviert Windows-Apps in der aktuellen Windows-App-Liste des Benutzers.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList <template path>	Bestimmt, ob eine bestimmte Einstellungsspeicherortvorlage ihrem XML-Schema entspricht.

Hinweis
Wenn eine Liste der Paketfamiliennamen vom WMI-Befehl aufgerufen wird, muss die Liste in Anführungszeichen stehen und beispielsweise durch ein Pipesymbol "<package family name | package family name>"getrennt sein.

Bereitstellen des UE-V-Agents mithilfe von Windows PowerShell

Bereitstellen des UE-V-Agents mithilfe von Windows PowerShell

1. Bereitstellen des UE-V-Agent-Installationspakets in einer barrierefreien Netzwerkfreigabe.

   Hinweis
   Verwenden Sie AgentSetup.exe, um sowohl 32-Bit- als auch 64-Bit-Versionen des UE-V-Agents bereitzustellen. Die 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 einen der folgenden Windows PowerShell Befehle, um den UE-V-Agent 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 ein UE-V-Problem? Verwenden Sie das UE-V TechNet-Forum.

Verwandte Themen

Verwalten von UE-V 2.x mit Windows PowerShell und WMI

Verwalten von UE-V 2.x