Partager via

Gestion de l’agent ET des packages UE-V 2.1 SP1 avec Windows PowerShell et WMI

  • Article

Vous pouvez utiliser WMI (Windows Management Instrumentation) et Windows PowerShell pour gérer le comportement de configuration et de synchronisation de l’agent Microsoft User Experience Virtualization (UE-V) 2.1 SP1. Pour obtenir la liste complète des applets de commande Ue-V PowerShell, consultez référence sur les applets de commande MDOP.

Pour déployer l’agent UE-V à l’aide de Windows PowerShell

  1. Phasez le fichier du programme d’installation 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%

Pour configurer l’agent UE-V à l’aide de Windows PowerShell

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

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

Commande de Windows PowerShell Description
Get-UevConfiguration Obtient 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 Obtient les valeurs des paramètres de l’agent UE-V pour l’utilisateur actuel uniquement.
Get-UevConfiguration -Computer Obtient les valeurs des paramètres de configuration de l’agent UE-V pour tous les utilisateurs sur l’ordinateur.
Get-UevConfiguration -Details Obtient les détails de chaque paramètre de configuration. Affiche l’emplacement où le paramètre est configuré 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 affiché dans le Centre des paramètres de l’entreprise pour le lien d’aide.
Set-UevConfiguration -Computer -ContactITUrl <string> Définit l’URL du lien dans le Centre des paramètres de l’entreprise pour le lien d’aide. N’importe quel protocole d’URL peut être utilisé.
Set-UevConfiguration -Computer -EnableDontSyncWindows8AppSettings Configure l’agent UE-V pour ne synchroniser aucune application Windows pour tous les utilisateurs sur l’ordinateur.
Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings Configure l’agent UE-V pour ne synchroniser aucune application Windows pour l’utilisateur actuel de l’ordinateur.
Set-UevConfiguration -Computer -EnableFirstUseNotification Configure l’agent UE-V pour afficher la notification la première fois que l’agent s’exécute pour tous les utilisateurs sur l’ordinateur.
Set-UevConfiguration -Computer -DisableFirstUseNotification Configure l’agent UE-V pour ne pas afficher de notification la première fois que l’agent s’exécute pour tous les utilisateurs sur l’ordinateur.
Set-UevConfiguration -Computer -EnableSettingsImportNotify Configure l’agent UE-V pour avertir tous les utilisateurs sur 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 l’agent UE-V pour avertir 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 l’agent UE-V pour synchroniser toutes les applications Windows qui ne sont pas explicitement désactivées par la liste des applications Windows pour tous les utilisateurs de l’ordinateur. Utilisez le DisableSyncUnlistedWindows8Apps paramètre pour configurer l’agent UE-V afin de synchroniser uniquement les applications Windows qui sont explicitement activées par la liste des applications Windows.
Set-UevConfiguration -CurrentComputerUser -EnableSyncUnlistedWindows8Apps Configure l’agent UE-V pour synchroniser toutes les applications Windows qui ne sont pas explicitement désactivées par la liste des applications Windows pour l’utilisateur actuel sur l’ordinateur. Utilisez le DisableSyncUnlistedWindows8Apps paramètre pour configurer l’agent UE-V afin de synchroniser uniquement les applications Windows qui sont explicitement activées par la liste des applications Windows.
Set-UevConfiguration -Computer -DisableSync Désactive UE-V pour tous les utilisateurs sur l’ordinateur. Utilisez le paramètre EnableSync pour activer ou réactiver.
Set-UevConfiguration -CurrentComputerUser -DisableSync Désactive UE-V pour l’utilisateur actuel sur l’ordinateur. Utilisez le paramètre EnableSync pour activer ou 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 l’agent UE-V pour qu’il signale lorsqu’une taille de fichier de package de paramètres atteint le seuil défini pour tous les utilisateurs sur l’ordinateur. Définit la taille du package de seuil en octets.
Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes> Configure l’agent UE-V pour qu’il signale lorsqu’une taille de fichier de package de paramètres atteint le seuil défini. Définit le seuil d’avertissement de taille de package pour l’utilisateur actuel.
Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds Spécifie le délai en secondes avant que l’utilisateur ne soit averti pour tous les utilisateurs de l’ordinateur.
Set-UevConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds Spécifie le délai en secondes avant l’envoi de la notification pour l’utilisateur actuel.
Set-UevConfiguration -Computer -SettingsStoragePath <path to settings storage location> Définit un emplacement de stockage des paramètres par ordinateur pour tous les utilisateurs de l’ordinateur.
Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to settings storage location> Définit un emplacement de stockage des paramètres par utilisateur.
Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <path to catalog> Définit le chemin du catalogue des 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’attente de synchronisation pour l’utilisateur actuel.
Clear-UevConfiguration -Computer -<setting name> Efface le paramètre spécifié pour tous les utilisateurs sur l’ordinateur.
Clear-UevConfiguration -CurrentComputerUser -<setting name> Efface le 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 de paramètres. L’extension de nom de fichier doit être .uev. L’applet de commande Export exporte tous les paramètres de l’agent UE-V configurables avec le paramètre Ordinateur.
Import-UevConfiguration <settings migration file> Importe la configuration de l’ordinateur UE-V à partir d’un fichier de migration de paramètres. L’extension de nom de fichier doit être .uev.

Pour exporter les paramètres de package UE-V et réparer des 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.

    Commande de Windows 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.

Pour configurer l’agent UE-V à l’aide de 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 sur 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 Windows PowerShell.

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

    Commande de Windows PowerShell Description
    Get-WmiObject -Namespace root\Microsoft\UEV Configuration Affiche les paramètres actifs de l’agent UE-V. Les paramètres spécifiques à l’utilisateur sont prioritaires sur les paramètres de l’ordinateur.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration Affiche la configuration de l’agent UE-V définie pour un utilisateur.
    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration Affiche la configuration de l’agent UE-V définie pour un ordinateur.
    Get-WmiObject -Namespace root\Microsoft\Uev ConfigurationItem Affiche les détails de chaque élément de configuration.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SettingsStoragePath = <path_to_settings_storage_location>
    $config.Put()    		 Définit 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éfinit 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é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 l’agent UE-V pour qu’il signale lorsqu’une taille de fichier de package de paramètres atteint un seuil défini. Définissez la taille du fichier de package de seuil 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 spécifique, effacez le paramètre et utilisez $null comme valeur de paramètre. 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 spécifique par ordinateur, effacez-le et utilisez $null comme valeur de paramètre. Utilisez la configuration utilisateur 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 spécifique. Pour effacer le paramètre, utilisez $null comme valeur de paramètre.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 Met à jour un paramètre par utilisateur spécifique pour tous les utilisateurs de l’ordinateur. Pour effacer le paramètre, utilisez $null comme valeur de paramètre.

Lors de la configuration de l’agent UE-V 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 de commandes WMI suivant. Les administrateurs peuvent utiliser cette interface pour exporter un package ou 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 dans un format XML lisible par l’utilisateur.
    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.

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

Administration d’UE-V 2.1 SP1