Gestion des modèles d’emplacement des paramètres UE-V 2.1 SP1 à l’aide de Windows PowerShell et WMI

  • Article

Microsoft User Experience Virtualization (UE-V) 2.1 SP1 utilise des modèles d’emplacement de paramètres XML pour définir les paramètres capturés et appliqués par UE-V. UE-V inclut un ensemble de modèles d’emplacement de paramètres standard. Il inclut également l’outil Générateur UE-V qui vous permet de créer des modèles d’emplacement de paramètres personnalisés. Après avoir créé et déployé des modèles d’emplacement de paramètres, vous pouvez gérer ces modèles à l’aide de Windows PowerShell et de Windows Management Instrumentation (WMI). Pour obtenir la liste complète des applets de commande Ue-V PowerShell, consultez référence sur les applets de commande MDOP.

Gérer les modèles d’emplacement des paramètres UE-V 2 à l’aide de Windows PowerShell

Les fonctionnalités WMI et Windows PowerShell d’UE-V incluent la possibilité d’activer, désactiver, inscrire, mettre à jour et annuler l’inscription des modèles d’emplacement des paramètres. À l’aide de ces fonctionnalités, vous pouvez automatiser le processus d’inscription, de mise à jour ou de désinscription des modèles auprès de l’agent UE-V. Vous pouvez également inscrire manuellement des modèles à l’aide des commandes WMI et Windows PowerShell. En utilisant ces fonctionnalités avec une solution de distribution électronique de logiciels, une stratégie de groupe ou une autre méthode de déploiement automatisé telle qu’un script, vous pouvez automatiser davantage ce processus.

Vous devez disposer des autorisations d’administrateur pour mettre à jour, inscrire ou annuler l’inscription d’un modèle d’emplacement de paramètres. Les autorisations d’administrateur ne sont pas nécessaires pour activer, désactiver ou lister les modèles.

Pour gérer les modèles d’emplacement des paramètres à l’aide de Windows PowerShell

  1. Utilisez un compte disposant de droits d’administrateur pour ouvrir une invite de commandes Windows PowerShell.

  2. Pour inscrire et gérer les modèles d’emplacement des paramètres UE-V, utilisez les applets de commande Windows PowerShell suivantes :

    Commande de Windows PowerShell Description
    Get-UevTemplate Répertorie tous les modèles d’emplacement des paramètres qui sont inscrits sur l’ordinateur.
    Get-UevTemplate -Application <string> Répertorie tous les modèles d’emplacement de paramètres qui sont inscrits sur l’ordinateur où le nom de l’application ou le nom du modèle contient <string>.
    Get-UevTemplate -TemplateID <string> Répertorie tous les modèles d’emplacement de paramètres qui sont inscrits sur l’ordinateur où l’ID de modèle contient <string>.
    Get-UevTemplate [-ApplicationOrTemplateID] <string> Répertorie tous les modèles d’emplacement de paramètres qui sont inscrits sur l’ordinateur où le nom de l’application ou du modèle, ou l’ID de modèle contient <string>.
    Get-UevTemplateProgram [-ID] <template ID> Obtient le nom du programme et les informations de version, qui dépendent de l’ID de modèle.
    Get-UevAppXPackage Obtient la liste effective des applications Windows.
    Get-UevAppXPackage -Computer Obtient la liste des applications Windows configurées pour l’ordinateur.
    Get-UevAppXPackage -CurrentComputerUser Obtient la liste des applications Windows configurées pour l’utilisateur actuel.
    Register-UevTemplate [-Path] <template file path>[,<template file path>] Inscrit un ou plusieurs modèles d’emplacement de paramètres avec UE-V en utilisant des chemins d’accès relatifs et/ou des caractères génériques dans les chemins d’accès de fichier. Une fois qu’un modèle est inscrit, UE-V synchronise les paramètres définis dans le modèle entre les ordinateurs sur lesquels le modèle est inscrit.
    Register-UevTemplate -LiteralPath <template file path>[,<template file path>] Inscrit un ou plusieurs modèles d’emplacement de paramètres avec UE-V à l’aide de chemins littéraux, où aucun caractère ne peut être interprété comme caractère générique. Une fois qu’un modèle est inscrit, UE-V synchronise les paramètres définis dans le modèle entre les ordinateurs sur lesquels le modèle est inscrit.
    Unregister-UevTemplate [-ID] <template ID> Annule l’inscription d’un modèle d’emplacement de paramètres avec UE-V. Lorsqu’un modèle est désinscrit, UE-V ne synchronise plus les paramètres définis dans le modèle entre les ordinateurs.
    Unregister-UevTemplate -All Annule l’inscription de tous les modèles d’emplacement de paramètres avec UE-V. Lorsqu’un modèle est désinscrit, UE-V ne synchronise plus les paramètres définis dans le modèle entre les ordinateurs.
    Update-UevTemplate [-Path] <template file path>[,<template file path>] Met à jour un ou plusieurs modèles d’emplacement de paramètres avec une version plus récente du modèle. Utilisez des chemins d’accès relatifs et/ou des caractères génériques dans les chemins d’accès aux fichiers. Le nouveau modèle doit être une version plus récente que le modèle existant.
    Update-UevTemplate -LiteralPath <template file path>[,<template file path>] Met à jour un ou plusieurs modèles d’emplacement de paramètres avec une version plus récente du modèle. Utilisez des chemins d’accès complets aux fichiers modèles, où aucun caractère ne peut être interprété comme des caractères génériques. Le nouveau modèle doit être une version plus récente que le modèle existant.
    Clear-UevAppXPackage -Computer [-PackageFamilyName] <package family name>[,<package family name>] Supprime une ou plusieurs applications Windows de la liste des applications Windows de l’ordinateur.
    Clear-UevAppXPackage -CurrentComputerUser Supprime l’application Windows de la liste des applications Windows de l’utilisateur actuel.
    Clear-UevAppXPackage -Computer -All Supprime toutes les applications Windows de la liste des applications Windows de l’ordinateur.
    Clear-UevAppXPackage [-CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>] Supprime une ou plusieurs applications Windows de la liste des applications Windows de l’utilisateur actuel.
    Clear-UevAppXPackage [-CurrentComputerUser] -All Supprime toutes les applications Windows de la liste des applications Windows de l’utilisateur actuel.
    Disable-UevTemplate [-ID] <template ID> Désactive un modèle d’emplacement de paramètres pour l’utilisateur actuel de l’ordinateur.
    Disable-UevAppXPackage -Computer [-PackageFamilyName] <package family name>[,<package family name>] Désactive une ou plusieurs applications Windows dans la liste des applications Windows de l’ordinateur.
    Disable-UevAppXPackage [-CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>] Désactive une ou plusieurs applications Windows dans la liste des applications Windows utilisateur actuelles.
    Enable-UevTemplate [-ID] <template ID> Active un modèle d’emplacement de paramètres pour l’utilisateur actuel de l’ordinateur.
    Enable-UevAppXPackage -Computer [-PackageFamilyName] <package family name>[,<package family name>] Active une ou plusieurs applications Windows dans la liste des applications Windows de l’ordinateur.
    Enable-UevAppXPackage [-CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>] Active une ou plusieurs applications Windows dans la liste des applications Windows utilisateur actuelle.
    Test-UevTemplate [-Path] <template file path>[,<template file path>] Détermine si un ou plusieurs modèles d’emplacement de paramètres sont conformes à son schéma XML. Peut utiliser des chemins d’accès relatifs et des caractères génériques.
    Test-UevTemplate -LiteralPath <template file path>[,<template file path>] Détermine si un ou plusieurs modèles d’emplacement de paramètres sont conformes à son schéma XML. Le chemin d’accès doit être un chemin d’accès complet au fichier de modèle, mais n’inclut pas de caractères génériques.

Les fonctionnalités Windows PowerShell UE-V vous permettent de gérer un groupe de modèles de paramètres déployés dans votre entreprise. Utilisez la procédure suivante pour gérer un groupe de modèles à l’aide de Windows PowerShell.

Pour gérer un groupe de modèles d’emplacement de paramètres à l’aide de Windows PowerShell

  1. Modifiez ou mettez à jour les modèles d’emplacement des paramètres souhaités.

  2. Si vous souhaitez modifier ou mettre à jour les modèles d’emplacement des paramètres, déployez ces modèles d’emplacement de paramètres dans un dossier accessible à l’ordinateur local.

  3. Sur l’ordinateur local, ouvrez une fenêtre Windows PowerShell avec des droits d’administrateur.

  4. Annulez l’inscription de toutes les versions précédemment inscrites des modèles en tapant la commande suivante.

    Unregister-UevTemplate -All

    Cette commande annule l’inscription de tous les modèles actifs sur l’ordinateur.

  5. Inscrivez les modèles mis à jour en tapant la commande suivante.

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

    Cette commande inscrit tous les modèles d’emplacement des paramètres qui se trouvent dans le dossier de modèle spécifié.

Liste des applications Windows

En répertoriant une application Windows dans la liste des applications Windows, vous spécifiez si cette application est activée ou désactivée pour la synchronisation des paramètres. Les applications sont identifiées dans la liste par leur nom de famille de packages et si la synchronisation des paramètres doit être activée ou désactivée pour cette application. Lorsque vous utilisez ces paramètres avec le paramètre Comportement de synchronisation par défaut non répertorié, vous pouvez contrôler si les applications Windows sont synchronisées.

Pour afficher le nom de la famille de packages des applications Windows installées, à l’invite de commandes Windows PowerShell, entrez :

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

Pour afficher la liste des applications Windows qui peuvent synchroniser les paramètres sur un ordinateur avec leur nom de famille de package, leur état activé et leur source activée, à l’invite de commandes Windows PowerShell, entrez : Get-UevAppxPackage

Définitions des propriétés Get-UevAppxPackage

  • DisplayName : nom affiché à l’utilisateur dans l’application Centre des paramètres de l’entreprise. La DisplayName propriété est dérivée de la PackageFamilyName propriété .

  • PackageFamilyName : nom du package installé pour l’utilisateur actuel.

  • Activé : définit si les paramètres de l’application sont configurés pour se synchroniser.

  • EnabledSource : emplacement où la configuration qui active ou désactive l’application est définie. Les valeurs possibles sont : NotSet, LocalMachine, LocalUser, PolicyMachine et PolicyUser.

  • NotSet : la stratégie n’est pas configurée pour synchroniser cette application.

  • LocalMachine : l’état activé est défini dans la section ordinateur local du Registre.

  • LocalUser : l’état activé est défini dans la section utilisateur actuelle du Registre.

  • PolicyMachine : l’état activé est défini dans la section stratégie de la section ordinateur local du Registre.

Pour obtenir la liste des applications Windows configurée par l’utilisateur, à l’invite de commandes Windows PowerShell, entrez : Get-UevAppxPackage -CurrentComputerUser

Pour obtenir la liste des applications Windows configurées par ordinateur, à l’invite de commandes Windows PowerShell, entrez : Get-UevAppxPackage -Computer

Pour les paramètres CurrentComputerUser ou Computer, l’applet de commande retourne une liste des applications Windows configurées au niveau de l’utilisateur ou de l’ordinateur.

Définitions des propriétés

  • DisplayName : nom affiché à l’utilisateur dans l’application Centre des paramètres de l’entreprise. La DisplayName propriété est dérivée de la PackageFamilyName propriété .

  • PackageFamilyName : nom du package installé pour l’utilisateur actuel.

  • Activé : définit si les paramètres de l’application sont configurés pour se synchroniser pour le commutateur spécifié, c’est-à-dire l’utilisateur ou l’ordinateur.

  • Installé : True, si est PackageFamilyName installé pour l’utilisateur actuel.

Gérer les modèles d’emplacement des paramètres UE-V 2 à l’aide de WMI

UE-V fournit l’ensemble de commandes WMI suivant. Les administrateurs peuvent utiliser ces interfaces pour gérer les modèles d’emplacement des paramètres à partir de Windows PowerShell et automatiser les tâches d’administration des modèles.

  1. Utilisez un compte disposant de droits d’administrateur pour ouvrir une fenêtre Windows PowerShell.

  2. Utilisez les commandes WMI suivantes pour inscrire et gérer les modèles d’emplacement des paramètres UE-V.

    Commande de Windows PowerShell Description
    Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate \ | Select-Object TemplateId,TemplateName, TemplateVersion,Enabled \ | Format-Table -Autosize Répertorie tous les modèles d’emplacement des paramètres qui sont inscrits pour l’ordinateur.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name GetProcessInfoByTemplateId <template Id> Obtient le nom du programme et les informations de version, qui dépendent du nom du modèle.
    Get-WmiObject -Namespace root\Microsoft\UEV EffectiveWindows8App Obtient la liste effective des applications Windows.
    Get-WmiObject -Namespace root\Microsoft\UEV MachineConfiguredWindows8App Obtient la liste des applications Windows configurées pour l’ordinateur.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguredWindows8App Obtient la liste des applications Windows configurées pour l’utilisateur actuel.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Register -ArgumentList <template path> Inscrit un modèle d’emplacement de paramètres avec UE-V.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name UnregisterByTemplateId -ArgumentList <template ID> Annule l’inscription d’un modèle d’emplacement de paramètres avec UE-V. Dès qu’un modèle est désinscrit, UE-V ne synchronise plus les paramètres définis dans le modèle entre les ordinateurs.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList <template path> Met à jour un modèle d’emplacement de paramètres avec UE-V. Le nouveau modèle doit être une version plus récente que l’existant.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name \ | package family name> Supprime une ou plusieurs applications Windows de la liste des applications Windows de l’ordinateur.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name \ | package family name> Supprime une ou plusieurs applications Windows de la liste des applications Windows de l’utilisateur actuel.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name DisableByTemplateId -ArgumentList <template ID> Désactive un ou plusieurs modèles d’emplacement de paramètres avec UE-V.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name DisableApp -ArgumentList <package family name \ | package family name> Désactive une ou plusieurs applications Windows dans la liste des applications Windows de l’ordinateur.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name DisableApp -ArgumentList <package family name \ | package family name> Désactive une ou plusieurs applications Windows dans la liste des applications Windows utilisateur actuelles.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name EnableByTemplateId -ArgumentList <template ID> Active un modèle d’emplacement de paramètres avec UE-V.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name EnableApp -ArgumentList <package family name \ | package family name> Active les applications Windows dans la liste des applications Windows de l’ordinateur.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <package family name \ | package family name> Active les applications Windows dans la liste des applications Windows de l’utilisateur actuel.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList <template path> Détermine si un modèle d’emplacement de paramètres donné est conforme à son schéma XML.

Remarque

Lorsqu’une liste de noms de familles de packages est appelée par la commande WMI, la liste doit être entre guillemets et séparée par un symbole de canal, par exemple, "<package family name | package family name>".

Déploiement de l’agent UE-V à l’aide de Windows PowerShell

  1. Mettre en place le package d’installation de l’agent UE-V dans un partage réseau accessible.

    Remarque

    Utilisez AgentSetup.exe pour déployer les versions 32 bits et 64 bits de l’agent UE-V. Les packages Windows Installer, AgentSetupx86.msi et AgentSetupx64.msi, sont disponibles pour chaque architecture. Pour désinstaller l’agent UE-V ultérieurement à l’aide du fichier d’installation, vous devez utiliser le même type de fichier.

  2. Pour installer l’agent UE-V, utilisez l’une des commandes Windows PowerShell suivantes.

    & 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%

Administration d’UE-V 2.1 SP1 avec Windows PowerShell et WMI

Administration d’UE-V 2.1 SP1