Partager via

Gestion de UE-V 1.0 Agent et des packages avec PowerShell et WMI

  • Article

Mis à jour: avril 2013

S'applique à: User Experience Virtualization 1.0

Vous pouvez utiliser WMI et PowerShell pour gérer le comportement de Microsoft User Experience Virtualization (UE-V) Agent en termes de configuration et de synchronisation.

Comment déployer UE-V Agent avec PowerShell

  1. Placez provisoirement le fichier du programme d'installation de UE-V dans un partage réseau accessible.

    Notes

    Utilisez AgentSetup.exe pour déployer à la fois les versions 32 bits et 64 bits de UE-V Agent. Les versions des fichiers Windows Installer, AgentSetupx86.msi et AgentSetupx64.msi, sont disponibles pour chacune des architectures. Pour désinstaller UE-V Agent par la suite à l'aide du fichier d'installation, vous devrez utiliser le même type de fichier.

  2. Utilisez l'une des commandes PowerShell suivantes pour installer l'agent.

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

Comment configurer UE-V Agent avec PowerShell

  1. Utilisez un compte disposant de droits d'administrateur pour ouvrir une fenêtre PowerShell. Importez le module PowerShell de UE-V à l'aide de la commande suivante.

    Import-module UEV

  2. Utilisez les commandes de PowerShell suivantes pour configurer l'agent.

    Commande PowerShell

    Description

    Get-UevConfiguration

    Permet d'afficher les paramètres de UE-V Agent en vigueur. Les paramètres spécifiques à l'utilisateur ont la priorité sur les paramètres de l'ordinateur.

    Get-UevConfiguration -CurrentComputerUser

    Permet d'afficher les valeurs des paramètres de UE-V Agent pour l'utilisateur actuel uniquement.

    Get-UevConfiguration -Computer

    Permet d'afficher les valeurs des paramètres de configuration de UE-V Agent pour tous les utilisateurs de l'ordinateur.

    Set-UevConfiguration -Computer -SettingsStoragePath <chemin_accès_emplacement_stockage_paramètres>

    Permet de définir un emplacement de stockage des paramètres par ordinateur.

    Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <chemin_accès_emplacement_stockage_paramètres>

    Permet de définir un emplacement de stockage des paramètres par utilisateur.

    Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <délai_expiration_en_millisecondes>

    Permet de définir le délai d'expiration de la synchronisation en millisecondes.

    Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <délai_expiration_en_millisecondes>

    Permet de définir le délai d'expiration de la synchronisation pour l'utilisateur actuel.

    Set-UevConfiguration -Computer -MaxPackageSizeInBytes <taille_en_octets>

    Permet de configurer UE-V Agent pour qu'il émette un avertissement lorsque la taille de fichier du package de paramètres atteint un seuil défini. Définissez le seuil de la taille du package en octets.

    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <taille_en_octets>

    Permet de définir le seuil d'avertissement en cas de dépassement de la taille du package pour l'utilisateur actuel.

    Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <chemin_accès_catalogue>

    Permet de définir le chemin d'accès au catalogue de modèles de paramètres.

    Set-UevConfiguration -Computer -SyncMethod <méthode_synchronisation>

    Permet de définir la méthode de synchronisation : Fichiers hors connexion ou Aucune.

    Set-UevConfiguration -CurrentComputerUser -SyncMethod <méthode_synchronisation>

    Permet de définir la méthode de synchronisation pour l'utilisateur actuel : Fichiers hors connexion ou Aucune.

    Set-UEVConfiguration -Computer -EnableSettingsImportNotify

    Permet d'émettre une notification en cas de retard de l'importation des paramètres de l'utilisateur.

    Utilisez -DisableSettingsImportNotify pour désactiver la notification.

    Set-UEVConfiguration -CurrentComputerUser -EnableSettingsImportNotify

    Permet d'émettre une notification pour l'utilisateur actuel en cas de retard de l'importation des paramètres de l'utilisateur.

    Utilisez -DisableSettingsImportNotify pour désactiver la notification.

    Set-UEVConfiguration -Computer -SettingsImportNotifyDelayInSeconds

    Permet de spécifier la durée (en secondes) qui s'écoule avant la notification de l'utilisateur.

    Set-UEVConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds

    Permet de spécifier la durée (en secondes) qui s'écoule avant la notification de l'utilisateur actuel.

    Set-UevConfiguration -Computer -DisableSync

    Permet de désactiver UE-V pour tous les utilisateurs de l'ordinateur.

    Utilisez -EnableSync pour l'activer ou le réactiver.

    Set-UevConfiguration -CurrentComputerUser -DisableSync

    Permet de désactiver UE-V pour l'utilisateur actuel de l'ordinateur.

    Utilisez -EnableSync pour l'activer ou le réactiver.

    Clear-UevConfiguration -Computer -<nom_paramètre>

    Permet d'effacer un paramètre particulier pour tous les utilisateurs de l'ordinateur.

    Clear-UevConfiguration -CurrentComputerUser -<nom_paramètre>

    Permet d'effacer un paramètre spécifique pour l'utilisateur actuel uniquement.

    Export-UevConfiguration <fichier_migration_paramètres>

    Permet d'exporter la configuration de l'ordinateur UE-V vers un fichier de migration des paramètres. L'extension du fichier doit être « .uev ».

    L'applet de commande d'exportation exporte tous les paramètres de UE-V Agent qui peuvent être configurés à l'aide du paramètre -computer.

    Import-UevConfiguration <fichier_migration_paramètres>

    Permet d'importer la configuration de l'ordinateur UE-V à partir d'un fichier de migration des paramètres (fichier .uev).

Comment exporter les paramètres de package UE-V et réparer les modèles UE-V avec PowerShell

  1. Ouvrez une fenêtre PowerShell en tant qu'administrateur. Importez le module PowerShell de UE-V à l'aide de la commande suivante.

    Import-module UEV

  2. Utilisez les commandes de PowerShell suivantes pour configurer l'agent.

    Commande PowerShell

    Description

    Export-UevPackage MicrosoftCalculator6.pkgx

    Extrait les paramètres à partir d'un fichier de package Microsoft Calculator et les convertit en un format lisible dans XML.

    Repair-UevTemplateIndex

    Répare l'index des modèles d'emplacement des paramètres UE-V.

Comment configurer UE-V Agent avec WMI

  1. User Experience Virtualization fournit l'ensemble suivant de commandes WMI. Les administrateurs peuvent utiliser cette interface pour configurer UE-V Agent à partir de la ligne de commande et automatiser les tâches de configuration les plus classiques.

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

  2. Utilisez les commandes WMI suivantes pour configurer l'agent.

    Commande WMI Description

    Get-WmiObject -Namespace root\Microsoft\UEV Configuration

    Permet d'afficher les paramètres de UE-V Agent en vigueur. Les paramètres spécifiques à l'utilisateur ont la priorité sur les paramètres de l'ordinateur.

    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    Permet d'afficher la configuration de UE-V Agent qui est définie pour l'utilisateur.

    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    Permet d'afficher la configuration de UE-V Agent qui est définie pour l'ordinateur.

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

    $config.SettingsStoragePath = <chemin_accès_emplacement_stockage_paramètres>

    $config.Put()

    Permet de définir un emplacement de stockage des paramètres par ordinateur.

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

    $config.SettingsStoragePath = <chemin_accès_emplacement_stockage_paramètres>

    $config.Put()

    Permet de définir un emplacement de stockage des paramètres par utilisateur.

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

    $config.SyncTimeoutInMilliseconds = <délai_expiration_en_millisecondes>

    $config.Put()

    Permet de définir le délai d'expiration de la synchronisation en millisecondes.

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

    $config.MaxPackageSizeInBytes = <taille_en_octets>

    $config.Put()

    Permet de configurer UE-V Agent pour qu'il émette un avertissement lorsque la taille de fichier du package de paramètres atteint un seuil défini. Définissez le seuil de la taille du fichier de package en octets.

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

    $config.SyncMethod = <méthode_synchronisation>

    $config.Put()

    Permet de définir la méthode de synchronisation : Fichiers hors connexion ou Aucune.

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

    $config.<nom_paramètre> = <valeur_paramètre>

    $config.Put()

    Permet de mettre à jour un paramètre propre à un ordinateur. Pour effacer le paramètre, utilisez $null comme valeur de paramètre.

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

    $config.<nom_paramètre> = <valeur_paramètre>

    $config.Put()

    Permet de mettre à jour un paramètre propre à un utilisateur. Pour effacer le paramètre, utilisez $null comme valeur de paramètre.

    Lors de la configuration de UE-V Agent avec WMI et PowerShell, la configuration définie est stockée dans le Registre dans les emplacements suivants :

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

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

Voir aussi

Autres ressources

Administration de UE-V 1.0
Opérations pour UE-V 1.0

-----
Vous pouvez en apprendre plus sur MDOP dans la bibliothèque TechNet, rechercher des informations sur le dépannage dans le Wiki TechNet ou nous suivre sur Facebook ouTwitter.
-----