Partager via

Gestion de l'agent UE-V 1.0 et des packages avec PowerShell et WMI

  • Article

Vous pouvez utiliser WMI et PowerShell pour gérer la configuration et le comportement de synchronisation de l’agent Microsoft User Experience Virtualization (UE-V).

Comment déployer l’agent UE-V avec PowerShell

  1. Phasez le fichier du programme d’installation UE-V dans un partage réseau accessible.

    Note Utilisez AgentSetup.exe pour déployer les versions 32 bits et 64 bits de l’agent UE-V. Les versions des fichiers 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. 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%

Guide pratique pour configurer l’agent UE-V avec PowerShell

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

    Import-module UEV

  2. Utilisez les commandes PowerShell suivantes pour configurer l’agent.

    Commande PowerShell

    Description

    Get-UevConfiguration

    Affichez les paramètres effectifs de l’agent UE-V. Les paramètres spécifiques à l’utilisateur sont prioritaires sur les paramètres de l’ordinateur.

    Get-UevConfiguration - CurrentComputerUser

    Affichez les valeurs des paramètres de l’agent UE-V pour l’utilisateur actuel uniquement.

    Get-UevConfiguration -Ordinateur

    Affichez les valeurs des paramètres de configuration de l’agent UE-V pour tous les utilisateurs sur l’ordinateur.

    Set-UevConfiguration -Ordinateur -SettingsStoragePath <chemin d’accès à _settings_storage_location>

    Définissez un emplacement de stockage des paramètres par ordinateur.

    Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <chemin d’accès à _settings_storage_location>

    Définissez un emplacement de stockage des paramètres par utilisateur.

    Set-UevConfiguration -Ordinateur -Délai d’expiration SyncTimeoutInMillisecondes <en millisecondes>

    Définir le délai d’expiration de la synchronisation en millisecondes

    Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMillisecondes <en millisecondes>

    Définissez le délai d’expiration de la synchronisation pour l’utilisateur actuel.

    Set-UevConfiguration -Ordinateur -MaxPackageSizeInBytes <taille en octets>

    Configurez l’agent UE-V pour qu’il signale quand la taille d’un fichier de package de paramètres atteint un seuil défini. Définissez la taille du package de seuil en octets.

    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <taille en octets>

    Définissez le seuil d’avertissement de taille de package pour l’utilisateur actuel.

    Set-UevConfiguration –Ordinateur –ParamètresTemplateCatalogPath <chemin d’accès au catalogue>

    Définissez le chemin du catalogue du modèle de paramètres.

    Set-UevConfiguration -Ordinateur -SyncMethod, méthode de <synchronisation>

    Définissez la méthode de synchronisation : OfflineFiles ou None.

    Set-UevConfiguration -CurrentComputerUser -SyncMethod sync, méthode de <synchronisation>

    Définissez la méthode de synchronisation pour l’utilisateur actuel : OfflineFiles ou None.

    Set-UEVConfiguration -Ordinateur –EnableSettingsImportNotify

    Activer la notification pour se produire lorsque l’importation des paramètres utilisateur est retardée.

    Utilisez –DisableSettingsImportNotify pour désactiver la notification.

    Set-UEVConfiguration - CurrentComputerUser -EnableSettingsImportNotify

    Activez la notification pour l’utilisateur actuel lorsque l’importation des paramètres utilisateur est retardée.

    Utilisez –DisableSettingsImportNotify pour désactiver la notification.

    Set-UEVConfiguration -Ordinateur -SettingsImportNotifyDelayInSeconds

    Spécifier le délai en secondes avant que l’utilisateur ne soit averti

    Set-UEVConfiguration - CurrentComputerUser -SettingsImportNotifyDelayInSeconds

    Spécifiez le délai en secondes avant la notification pour l’utilisateur actuel.

    Set-UevConfiguration –Ordinateur –DisableSync

    Désactivez UE-V pour tous les utilisateurs sur l’ordinateur.

    Utilisez –EnableSync pour activer ou réactiver.

    Set-UevConfiguration –CurrentComputerUser -DisableSync

    Désactivez UE-V pour l’utilisateur actuel sur l’ordinateur.

    Utilisez –EnableSync pour activer ou réactiver.

    Clear-UevConfiguration –Nom du paramètre de l’ordinateur<>

    Effacez un paramètre spécifique pour tous les utilisateurs sur l’ordinateur.

    Clear-UevConfiguration –CurrentComputerUser -nom du< paramètre>

    Effacez un paramètre spécifique pour l’utilisateur actuel uniquement.

    <Export-UevConfiguration fichier de migration des paramètres>

    Exportez la configuration de l’ordinateur UE-V vers un fichier de migration de paramètres. L’extension du fichier doit être « .uev ».

    L’applet de commande d’exportation exporte tous les paramètres de l’agent UE-V configurables avec le paramètre -computer.

    <Import-UevConfiguration fichier de migration des paramètres>

    Importez la configuration de l’ordinateur UE-V à partir d’un fichier de migration de paramètres (fichier .uev).

Guide pratique pour exporter des paramètres de package UE-V et réparer des modèles UE-V avec PowerShell

  1. Ouvrez une fenêtre PowerShell en tant qu’administrateur. Importez le module PowerShell UE-V avec la commande suivante.

    Import-module UEV

  2. Utilisez les commandes PowerShell suivantes pour configurer l’agent.

    Commande PowerShell

    Description

    Export-UevPackage MicrosoftCalculator6.pkgx

    Extrait les paramètres d’un fichier de package microsoft Calculator et les convertit dans un format XML lisible par l’utilisateur.

    Repair-UevTemplateIndex

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

Comment configurer l’agent UE-V avec WMI

  1. La virtualisation de l’expérience utilisateur fournit l’ensemble de commandes WMI suivant. Les administrateurs peuvent utiliser cette interface pour configurer l’agent UE-V à partir de la ligne de commande et automatiser les tâches de configuration 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 PowerShell Description

    Get-WmiObject -Namespace root\Microsoft\UEV Configuration

    Affichez les paramètres de l’agent UE-V actif. Les paramètres spécifiques à l’utilisateur sont prioritaires sur les paramètres de l’ordinateur.

    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    Affichez la configuration de l’agent UE-V définie pour l’utilisateur.

    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    Affichez la configuration de l’agent UE-V définie pour l’ordinateur.

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

    $config. SettingsStoragePath = <path_to_settings_storage_location>

    $config. Put()

    Définissez un emplacement de stockage des paramètres par ordinateur.

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

    $config. SettingsStoragePath = <path_to_settings_storage_location>

    $config. Put()

    Définissez un emplacement de stockage des paramètres par utilisateur.

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

    $config. SyncTimeoutInMilliseconds = <timeout_in_milliseconds>

    $config. Put()

    Définissez le délai d’expiration de la synchronisation en millisecondes.

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

    $config. MaxPackageSizeInBytes = <size_in_bytes>

    $config. Put()

    Configurez l’agent UE-V pour qu’il signale quand la taille d’un fichier de package de paramètres atteint un seuil défini. Définissez la taille du fichier de package de seuil en octets.

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

    $config. SyncMethod = <sync_method>

    $config. Put()

    Définissez la méthode de synchronisation : OfflineFiles ou None.

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

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

    $config. Put()

    Mettez à jour un paramètre par ordinateur spécifique. Pour effacer le paramètre, utilisez $null comme valeur de paramètre.

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

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

    $config. Put()

    Mettez à jour un paramètre par utilisateur spécifique. Pour effacer le paramètre, utilisez $null comme valeur de paramètre.

Lors de la configuration de l’agent UE-V avec WMI et 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

Administration d'UE-V 1.0

Opérations d'UE-V 1.0