Partager via

Gestion de UE-V 2.x Agent et des packages avec Windows PowerShell et WMI

  • Article

Mis à jour: août 2015

S'applique à: User Experience Virtualization 2.0, User Experience Virtualization 2.1

Vous pouvez utiliser Windows Management Instrumentation (WMI) et Windows PowerShell pour gérer la configuration et le comportement de synchronisation de Microsoft User Experience Virtualization (UE-V) 2.0, 2.1 et 2.1 SP1 Agent. Pour une liste complète des applets de commande PowerShell de UE-V, voir Référence sur les applets de commande UE-V 2 (https://go.microsoft.com/fwlink/?LinkId=393495).

Pour déployer UE-V Agent à l'aide de Windows 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 packages Windows Installer (AgentSetupx86.msi et AgentSetupx64.msi) sont disponibles pour chacune des architectures. Pour désinstaller UE-V Agent à l'aide du fichier d'installation, vous devrez utiliser le même type de fichier.

  2. Utilisez l'une des commandes Windows PowerShell suivantes pour installer UE-V 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%

Pour configurer UE-V Agent à l'aide de Windows PowerShell

  1. Ouvrez une fenêtre Windows PowerShell. Pour gérer les paramètres d'ordinateur qui affectent tous les utilisateurs d'un ordinateur à l'aide du paramètre Computer, ouvrez la fenêtre avec un compte disposant des droits d'administrateur.

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

    Commande Windows PowerShell Description 

    Get-UevConfiguration

    Obtient les paramètres UE-V Agent. Les paramètres spécifiques à l'utilisateur ont la priorité sur les paramètres de l'ordinateur.

    Get-UevConfiguration - CurrentComputerUser

    Obtient les valeurs des paramètres UE-V Agent pour l'utilisateur actuel uniquement.

    Get-UevConfiguration -Computer

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

    Get-UevConfiguration -Details

    Obtient les détails de chaque paramètre de configuration. Affiche l'emplacement auquel est configuré le paramètre ou s'il utilise la valeur par défaut. S'affiche si le paramètre actuel est valide.

    Set-UevConfiguration -Computer –ContactITDescription <IT description>

    Définit le texte du lien d'aide dans le Centre des paramètres de la société.

    Set-UevConfiguration -Computer -ContactITUrl <string>

    Définit l'URL du lien d'aide dans le Centre des paramètres de la société. N'importe quel protocole d'URL peut être utilisé.

    Set-UevConfiguration -Computer –EnableDontSyncWindows8AppSettings

    Configure UE-V Agent pour ne synchroniser aucune application Windows pour l'ensemble des utilisateurs de l'ordinateur.

    Set-UevConfiguration -CurrentComputerUser – EnableDontSyncWindows8AppSettings

    Configure UE-V Agent pour ne synchroniser aucune application Windows pour l'utilisateur actuel.

    Set-UevConfiguration -Computer –EnableFirstUseNotification

    Configure UE-V Agent de manière à afficher une notification lors de la première exécution de l'agent, pour l'ensemble des utilisateurs de l'ordinateur.

    Set-UevConfiguration -Computer –DisableFirstUseNotification

    Configure UE-V Agent de manière à ne pas afficher de notification lors de la première exécution de l'agent, pour l'ensemble des utilisateurs de l'ordinateur.

    Set-UevConfiguration -Computer –EnableSettingsImportNotify

    Configure UE-V Agent de manière à notifier tous les utilisateurs de l'ordinateur lorsque la synchronisation des paramètres est retardée.

    Utilisez le paramètre DisableSettingsImportNotify pour désactiver la notification.

    Set-UevConfiguration - CurrentComputerUser -EnableSettingsImportNotify

    Configure UE-V Agent pour informer l'utilisateur actuel lorsque la synchronisation des paramètres est retardée.

    Utilisez le paramètre DisableSettingsImportNotify pour désactiver la notification.

    Set-UevConfiguration -Computer –EnableSyncUnlistedWindows8Apps

    Configure UE-V Agent pour synchroniser toutes les applications Windows qui ne sont pas explicitement désactivées par la liste d'applications Windows, pour l'ensemble des utilisateurs de l'ordinateur. Pour plus d'informations, voir la section "Get-UevAppxPackage" dans Gestion des modèles d'emplacement des paramètres UE-V 2.x à l'aide de Windows PowerShell et WMI.

    Utilisez le paramètre DisableSyncUnlistedWindows8Apps pour configurer UE-V Agent pour synchroniser uniquement les applications Windows qui sont explicitement activées par la liste d'applications Windows.

    Set-UevConfiguration - CurrentComputerUser - EnableSyncUnlistedWindows8Apps

    Configure UE-V Agent pour synchroniser toutes les applications Windows qui ne sont pas explicitement désactivées par la liste d'applications Windows, pour l'utilisateur actuel de l'ordinateur. Pour plus d'informations, voir la section "Get-UevAppxPackage" dans Gestion des modèles d'emplacement des paramètres UE-V 2.x à l'aide de Windows PowerShell et WMI.

    Utilisez le paramètre DisableSyncUnlistedWindows8Apps pour configurer UE-V Agent pour synchroniser uniquement les applications Windows qui sont explicitement activées par la liste d'applications Windows.

    Set-UevConfiguration –Computer –DisableSync

    Désactive UE-V pour tous les utilisateurs de l'ordinateur.

    Utilisez le paramètre EnableSync pour l'activer ou le réactiver.

    Set-UevConfiguration –CurrentComputerUser -DisableSync

    Désactive UE-V pour l'utilisateur actuel de l'ordinateur.

    Utilisez le paramètre EnableSync pour l'activer ou le réactiver.

    Set-UevConfiguration -Computer –EnableTrayIcon

    Active l'icône UE-V dans la zone de notification pour tous les utilisateurs de l'ordinateur.

    Utilisez le paramètre DisableTrayIcon pour désactiver l'icône.

    Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes>

    Configure UE-V Agent de manière à informer l'ensemble des utilisateurs de l'ordinateur lorsque la taille d'un package de paramètres atteint le seuil défini. Définit le seuil de la taille du package en octets.

    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes>

    Configure UE-V Agent de manière à avertir lorsque la taille du package de paramètres atteint le seuil défini. Définit le seuil pour l'utilisateur actuel.

    Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds

    Spécifie la durée (en secondes) avant laquelle l'ensemble des utilisateurs de l'ordinateur reçoivent une notification.

    Set-UevConfiguration - CurrentComputerUser -SettingsImportNotifyDelayInSeconds

    Spécifie la durée (en secondes) avant laquelle l'utilisateur actuel reçoit une notification.

    Set-UevConfiguration -Computer -SettingsStoragePath <path to _settings_storage_location>

    Définit un emplacement de stockage de paramètres pour chaque ordinateur, pour tous les utilisateurs d'un ordinateur.

    Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to _settings_storage_location>

    Définit un emplacement de stockage des paramètres pour chaque utilisateur.

    Set-UevConfiguration –Computer –SettingsTemplateCatalogPath <path to catalog>

    Définit le chemin d'accès du catalogue de modèles de paramètres pour tous les utilisateurs de l'ordinateur.

    Set-UevConfiguration -Computer -SyncMethod <sync method>

    Définit la méthode de synchronisation pour tous les utilisateurs de l'ordinateur : SyncProvider ou None.

    Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method>

    Définit la méthode de synchronisation pour l'utilisateur actuel : SyncProvider ou None.

    Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds>

    Définit le délai d'attente de synchronisation (en millisecondes) pour tous les utilisateurs de l'ordinateur.

    Set- UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds>

    Définit le délai d'expiration de la synchronisation pour l'utilisateur actuel.

    Clear-UevConfiguration –Computer -<setting name>

    Efface un paramètre spécifié pour tous les utilisateurs de l'ordinateur.

    Clear-UevConfiguration –CurrentComputerUser -<setting name>

    Efface un paramètre spécifié pour l'utilisateur actuel uniquement.

    Export-UevConfiguration <settings migration file>

    Exporte 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 Export exporte tous les paramètres de UE-V Agent qui peuvent être configurés avec le paramètre Computer.

    Import-UevConfiguration <settings migration file>

    Importe la configuration de l'ordinateur UE-V à partir d'un fichier de paramètres de migration. L'extension du fichier doit être .uev.

Pour exporter les paramètres de package UE-V et réparer les modèles UE-V à l'aide de Windows PowerShell

  1. Ouvrez une fenêtre Windows PowerShell en tant qu'administrateur.

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

    Windows PowerShell commande

    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.

Pour configurer UE-V Agent à l'aide de WMI

  1. Virtualisation d'expérience utilisateur 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.

    Windows PowerShell command Description 

    Get-WmiObject -Namespace root\Microsoft\UEV Configuration

    Affiche les paramètres actuels de UE-V Agent. Les paramètres spécifiques à l'utilisateur ont la priorité sur les paramètres de l'ordinateur.

    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    Affiche la configuration de UE-V Agent qui est définie pour un utilisateur.

    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    Affiche la configuration de UE-V Agent qui est définie pour un ordinateur.

    Get-WmiObject –Namespace root\Microsoft\Uev ConfigurationItem

    Affiche les informations relatives à chaque élément de configuration.

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

    $config.SettingsStoragePath = <path_to_settings_storage_location>

    $config.Put()

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

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

    $config.SettingsStoragePath = <path_to_settings_storage_location>

    $config.Put()

    Définit un emplacement de stockage des paramètres pour chaque utilisateur.

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

    $config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds>

    $config.Put()

    Définit le délai d'attente de synchronisation (en millisecondes) pour tous les utilisateurs de l'ordinateur.

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

    $config.MaxPackageSizeInBytes = <size_in_bytes>

    $config.Put()

    Configure 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éfinit la taille limite du package en octets pour tous les utilisateurs de l'ordinateur.

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

    $config.SyncMethod = <sync_method>

    $config.Put()

    Définit la méthode de synchronisation pour tous les utilisateurs de l'ordinateur : SyncProvider ou None.

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

    $config.<setting name> = $true

    $config.Put()

    Pour activer un paramètre par ordinateur, supprimez sa valeur et remplacez-la par $null. Utilisez UserConfiguration pour les paramètres par utilisateur.

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

    $config.<setting name> = $false

    $config.Put()

    Pour désactiver un paramètre par ordinateur, supprimez sa valeur, puis remplacez-la par $null. Utilisez UserConfiguration pour les paramètres par utilisateur.

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

    $config.<setting name> = <setting value>

    $config.Put()

    Met à jour un paramètre par ordinateur. Pour désactiver le paramètre, utilisez $null comme valeur de paramètre.

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

    $config.<nom du paramètre> = <valeur du paramètre>

    $config.Put()

    Met à jour un paramètre par utilisateur pour tous les utilisateurs de l'ordinateur. Pour désactiver le paramètre, utilisez $null comme valeur de paramètre.

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

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

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

Pour exporter les paramètres de package UE-V et réparer des modèles UE-V à l'aide de WMI

  1. UE-V fournit l'ensemble suivant de commandes WMI. Les administrateurs peuvent utiliser cette interface pour exporter un package ou pour réparer des modèles UE-V.

  2. Utilisez les commandes WMI suivantes.

    Commande WMI Description 

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserSettings -Name ExportPackage -ArgumentList <package name>

    Extrait les paramètres d'un fichier de package et les convertit en un format XML lisible.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name RebuildIndex

    Répare l'index des modèles d'emplacement des paramètres UE-V. Doit être exécuté en tant qu'administrateur.

    Vous avez une suggestion pour UE-V ? Ajoutez des suggestions ou votez pour les meilleures ici.
    Vous rencontrez un problème avec UE-V ? Utilisez le Forum TechNet UE-V.

Voir aussi

Autres ressources

Administration d'UE-V 2.x avec Windows PowerShell et WMI
Administration de UE-V 2.x