Verwalten von UE-V 2.1 SP1-Einstellungsspeicherortvorlagen mithilfe von Windows PowerShell und WMI

  • Artikel

Microsoft User Experience Virtualization (UE-V) 2.1 SP1 verwendet XML-Einstellungsspeicherortvorlagen, um die Einstellungen zu definieren, die von UE-V erfasst und angewendet werden. UE-V enthält eine Reihe von Standardeinstellungsspeicherortvorlagen. Es enthält auch das Tool UE-V-Generator, mit dem Sie benutzerdefinierte Einstellungsspeicherortvorlagen erstellen können. Nachdem Sie Vorlagen zum Speicherort 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 in der MDOP-Cmdlet-Referenz.

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

Die WMI- und Windows PowerShell-Features von UE-V umfassen die Möglichkeit, Standortvorlagen für Einstellungen zu aktivieren, zu deaktivieren, zu registrieren, zu aktualisieren und die Registrierung aufzuheben. 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 mit einer elektronischen Softwareverteilungslösung, einer Gruppenrichtlinie oder einer anderen automatisierten Bereitstellungsmethode wie einem Skript verwenden, können Sie diesen Prozess weiter automatisieren.

Sie müssen über Administratorberechtigungen verfügen, um eine Einstellungsspeicherortvorlage zu aktualisieren, zu registrieren oder die Registrierung aufzuheben. Zum Aktivieren, Deaktivieren oder Auflisten von Vorlagen sind keine Administratorberechtigungen erforderlich.

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 enthält <string>.
    Get-UevTemplate -TemplateID <string> Listet alle Einstellungsspeicherortvorlagen auf, die auf dem Computer registriert sind, auf dem die Vorlagen-ID enthält <string>.
    Get-UevTemplate [-ApplicationOrTemplateID] <string> Listet alle Einstellungsspeicherortvorlagen auf, die auf dem Computer registriert sind, auf dem der Anwendungs- oder Vorlagenname oder die Vorlagen-ID enthält <string>.
    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 unter Verwendung relativer Pfade und/oder Vonzeichen 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, bei denen keine Zeichen als Wildcardzeichen 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 bei UE-V auf. Wenn die Registrierung einer Vorlage aufgehoben wird, synchronisiert UE-V die in der Vorlage definierten Einstellungen nicht mehr zwischen Computern.
    Unregister-UevTemplate -All Hebt die Registrierung aller Einstellungsspeicherortvorlagen bei UE-V auf. Wenn die Registrierung einer Vorlage aufgehoben wird, synchronisiert UE-V die in der Vorlage definierten Einstellungen nicht mehr zwischen Computern.
    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 Wildcardzeichen 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 Wildcardzeichen 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 Liste der aktuellen Windows-Apps des 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 Aktuellen Windows-App-Liste des Benutzers.
    Clear-UevAppXPackage [-CurrentComputerUser] -All Entfernt alle Windows-Apps aus der Windows-App-Liste 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 mindestens eine Windows-App 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 Aktuellen Windows-App-Liste des 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 Aktuellen Windows-App-Liste des Benutzers.
    Test-UevTemplate [-Path] <template file path>[,<template file path>] Bestimmt, ob eine oder mehrere Einstellungsspeicherortvorlagen dem XML-Schema entsprechen. Kann relative Pfade und Wildcardzeichen 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 Wildcardzeichen.

Mit den Windows PowerShell-Features von UE-V können Sie eine Gruppe von Einstellungsvorlagen verwalten, die in Ihrem Unternehmen bereitgestellt werden. Gehen Sie wie folgt vor, 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 vorlagen für die gewünschten Einstellungen.

  2. Wenn Sie die Einstellungsspeicherortvorlagen ändern oder aktualisieren möchten, stellen Sie diese Speicherortvorlagen für Einstellungen 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

    Dieser Befehl hebt die Registrierung aller aktiven Vorlagen auf dem Computer auf.

  5. 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 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 und anhand der Angabe identifiziert, 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 installierter Windows-Apps anzuzeigen, geben Sie an einer Windows PowerShell-Eingabeaufforderung Folgendes ein:

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

Um eine Liste von Windows-Apps anzuzeigen, die Einstellungen auf einem Computer mit ihrem Paketfamiliennamen, aktiviertem Status und aktivierter Quelle synchronisieren können, geben Sie an einer Windows PowerShell-Eingabeaufforderung Folgendes ein: Get-UevAppxPackage

Definitionen von Get-UevAppxPackage Eigenschaften

  • DisplayName: Der Name, der dem Benutzer in der Anwendung Unternehmenseinstellungscenter 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 festgelegt ist, die die App aktiviert oder deaktiviert. Mögliche Werte sind : NotSet, LocalMachine, LocalUser, PolicyMachine und PolicyUser.

  • NotSet: Die Richtlinie ist nicht für die Synchronisierung dieser App konfiguriert.

  • LocalMachine: Der status enabled wird im lokalen Computerabschnitt der Registrierung festgelegt.

  • LocalUser: Der status enabled wird im aktuellen Benutzerabschnitt der Registrierung festgelegt.

  • PolicyMachine: Der Status "Enabled" wird im Abschnitt "Policy" des lokalen Computers 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 Anwendung Unternehmenseinstellungscenter 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. für Benutzer oder Computer.

  • Installiert: True, wenn für PackageFamilyName den aktuellen Benutzer installiert ist.

Verwalten von UE-V 2-Einstellungsspeicherortvorlagen mithilfe von WMI

UE-V stellt den folgenden Satz von WMI-Befehlen bereit. Administratoren können diese Schnittstellen verwenden, um Einstellungsspeicherortvorlagen in Windows PowerShell zu verwalten und Administrative Aufgaben für Vorlagen zu automatisieren.

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

  2. Verwenden Sie die folgenden WMI-Befehle, um die Speicherortvorlagen für UE-V-Einstellungen zu registrieren und zu verwalten.

    Windows PowerShell-Befehl Beschreibung
    Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate \ | Select-Object TemplateId,TemplateName, TemplateVersion,Enabled \ | Format-Table -Autosize Listet alle Speicherortvorlagen für Einstellungen 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ängen.
    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 bei 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> 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 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 Aktuellen Windows-App-Liste des 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 mindestens eine Windows-App 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 Aktuellen Windows-App-Liste des 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 Windows-App-Liste des aktuellen Benutzers.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList <template path> Bestimmt, ob eine angegebene Einstellungsspeicherortvorlage dem XML-Schema entspricht.

Hinweis

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

Bereitstellen des UE-V-Agents mithilfe von Windows PowerShell

  1. Stufen Sie das UE-V-Agent-Installationspaket 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. 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 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%

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

Verwalten von UE-V 2.1 SP1