Compartir a través de

Administración del agente y los paquetes de UE-V 2.1 SP1 con Windows PowerShell y WMI

  • Artículo

Puede usar Instrumental de administración de Windows (WMI) y Windows PowerShell para administrar el comportamiento de sincronización y configuración del agente de Microsoft User Experience Virtualization (UE-V) 2.1 SP1. Para obtener una lista completa de los cmdlets de PowerShell de UE-V, consulte Referencia de cmdlets MDOP.

Para implementar el agente de UE-V mediante Windows PowerShell

  1. Almacene provisionalmente el archivo del instalador de UE-V en un recurso compartido de red accesible.

    Nota

    Use AgentSetup.exe para implementar versiones de 32 y 64 bits del agente de UE-V. Los paquetes de Windows Installer, AgentSetupx86.msi y AgentSetupx64.msi, están disponibles para cada arquitectura. Para desinstalar el agente de UE-V más adelante mediante el archivo de instalación, debe usar el mismo tipo de archivo.

  2. Para instalar el agente de UE-V, use uno de los siguientes comandos de Windows PowerShell:

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

Para configurar el agente de UE-V mediante Windows PowerShell

  1. Abra una ventana de Windows PowerShell. Para administrar la configuración del equipo que afecta a todos los usuarios del equipo mediante el parámetro Equipo , abra la ventana con una cuenta con derechos de administrador.

  2. Use los siguientes comandos de Windows PowerShell para configurar el agente.

Comando de Windows PowerShell Descripción
Get-UevConfiguration Obtiene la configuración efectiva del agente de UE-V. La configuración específica del usuario tiene prioridad sobre la configuración del equipo.
Get-UevConfiguration -CurrentComputerUser Obtiene los valores de configuración del agente de UE-V solo para el usuario actual.
Get-UevConfiguration -Computer Obtiene los valores de configuración del agente de UE-V para todos los usuarios del equipo.
Get-UevConfiguration -Details Obtiene los detalles de cada configuración. Muestra dónde está configurada la configuración o si usa el valor predeterminado. Se muestra si la configuración actual es válida.
Set-UevConfiguration -Computer -ContactITDescription <IT description> Establece el texto que se muestra en el Centro de configuración de empresa para el vínculo de ayuda.
Set-UevConfiguration -Computer -ContactITUrl <string> Establece la dirección URL del vínculo en el Centro de configuración de empresa para el vínculo de ayuda. Se puede usar cualquier protocolo de dirección URL.
Set-UevConfiguration -Computer -EnableDontSyncWindows8AppSettings Configura el agente de UE-V para que no sincronice ninguna aplicación de Windows para todos los usuarios del equipo.
Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings Configura el agente de UE-V para que no sincronice ninguna aplicación de Windows para el usuario del equipo actual.
Set-UevConfiguration -Computer -EnableFirstUseNotification Configura el agente de UE-V para mostrar la notificación la primera vez que el agente se ejecuta para todos los usuarios del equipo.
Set-UevConfiguration -Computer -DisableFirstUseNotification Configura el agente de UE-V para que no muestre la notificación la primera vez que el agente se ejecuta para todos los usuarios del equipo.
Set-UevConfiguration -Computer -EnableSettingsImportNotify Configura el agente de UE-V para notificar a todos los usuarios del equipo cuando se retrasa la sincronización de la configuración. Use el parámetro DisableSettingsImportNotify para deshabilitar la notificación.
Set-UevConfiguration -CurrentComputerUser -EnableSettingsImportNotify Configura el agente de UE-V para notificar al usuario actual cuando se retrasa la sincronización de la configuración. Use el parámetro DisableSettingsImportNotify para deshabilitar la notificación.
Set-UevConfiguration -Computer -EnableSyncUnlistedWindows8Apps Configura el Agente de UE-V para sincronizar todas las aplicaciones de Windows que no están deshabilitadas explícitamente por la lista de aplicaciones de Windows para todos los usuarios del equipo. Use el DisableSyncUnlistedWindows8Apps parámetro para configurar el Agente de UE-V para sincronizar solo las aplicaciones de Windows habilitadas explícitamente por la lista de aplicaciones de Windows.
Set-UevConfiguration -CurrentComputerUser -EnableSyncUnlistedWindows8Apps Configura el Agente de UE-V para sincronizar todas las aplicaciones de Windows que no están deshabilitadas explícitamente por la lista de aplicaciones de Windows para el usuario actual en el equipo. Use el DisableSyncUnlistedWindows8Apps parámetro para configurar el Agente de UE-V para sincronizar solo las aplicaciones de Windows habilitadas explícitamente por la lista de aplicaciones de Windows.
Set-UevConfiguration -Computer -DisableSync Deshabilita UE-V para todos los usuarios del equipo. Use el parámetro EnableSync para habilitar o volver a habilitar.
Set-UevConfiguration -CurrentComputerUser -DisableSync Deshabilita UE-V para el usuario actual en el equipo. Use el parámetro EnableSync para habilitar o volver a habilitar.
Set-UevConfiguration -Computer -EnableTrayIcon Habilita el icono UE-V en el área de notificación para todos los usuarios del equipo. Use el parámetro DisableTrayIcon para deshabilitar el icono.
Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes> Configura el agente de UE-V para informar cuando un tamaño de archivo de paquete de configuración alcanza el umbral definido para todos los usuarios del equipo. Establece el tamaño del paquete de umbral en bytes.
Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes> Configura el agente de UE-V para informar cuando un tamaño de archivo de paquete de configuración alcanza el umbral definido. Establece el umbral de advertencia de tamaño de paquete para el usuario actual.
Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds Especifica el tiempo en segundos antes de que se notifique al usuario para todos los usuarios del equipo.
Set-UevConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds Especifica el tiempo en segundos antes de que se envíe la notificación para el usuario actual.
Set-UevConfiguration -Computer -SettingsStoragePath <path to settings storage location> Define una ubicación de almacenamiento de configuración por equipo para todos los usuarios del equipo.
Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to settings storage location> Define una ubicación de almacenamiento de configuración por usuario.
Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <path to catalog> Establece la ruta de acceso del catálogo de plantillas de configuración para todos los usuarios del equipo.
Set-UevConfiguration -Computer -SyncMethod <sync method> Establece el método de sincronización para todos los usuarios del equipo: SyncProvider o None.
Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method> Establece el método de sincronización para el usuario actual: SyncProvider o None.
Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds> Establece el tiempo de espera de sincronización en milisegundos para todos los usuarios del equipo.
Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds> Establece el tiempo de espera de sincronización para el usuario actual.
Clear-UevConfiguration -Computer -<setting name> Borra la configuración especificada para todos los usuarios del equipo.
Clear-UevConfiguration -CurrentComputerUser -<setting name> Borra la configuración especificada solo para el usuario actual.
Export-UevConfiguration <settings migration file> Exporta la configuración del equipo UE-V a un archivo de migración de configuración. La extensión de nombre de archivo debe ser .uev. El cmdlet Export exporta toda la configuración del agente de UE-V que se puede configurar con el parámetro Computer .
Import-UevConfiguration <settings migration file> Importa la configuración del equipo UE-V desde un archivo de migración de configuración. La extensión de nombre de archivo debe ser .uev.

Para exportar la configuración del paquete UE-V y reparar plantillas de UE-V mediante Windows PowerShell

  1. Abra una ventana de Windows PowerShell como administrador.

  2. Use los siguientes comandos de Windows PowerShell para configurar el agente.

    Comando de Windows PowerShell Descripción
    Export-UevPackage MicrosoftCalculator6.pkgx Extrae la configuración de un archivo de paquete de Calculadora de Microsoft y los convierte en un formato legible en XML.
    Repair-UevTemplateIndex Repara el índice de las plantillas de ubicación de configuración de UE-V.

Para configurar el agente de UE-V mediante WMI

  1. Virtualización de experiencia de usuario proporciona el siguiente conjunto de comandos WMI. Los administradores pueden usar esta interfaz para configurar el agente de UE-V en la línea de comandos y automatizar las tareas de configuración típicas.

    Use una cuenta con derechos de administrador para abrir una ventana de Windows PowerShell.

  2. Use los siguientes comandos WMI para configurar el agente.

    Comando de Windows PowerShell Descripción
    Get-WmiObject -Namespace root\Microsoft\UEV Configuration Muestra la configuración activa del agente de UE-V. La configuración específica del usuario tiene prioridad sobre la configuración del equipo.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration Muestra la configuración del agente de UE-V definida para un usuario.
    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration Muestra la configuración del agente de UE-V definida para un equipo.
    Get-WmiObject -Namespace root\Microsoft\Uev ConfigurationItem Muestra los detalles de cada elemento de configuración.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SettingsStoragePath = <path_to_settings_storage_location>
    $config.Put()    		 Define una ubicación de almacenamiento de configuración por equipo.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration
    $config.SettingsStoragePath = <path_to_settings_storage_location>
    $config.Put()    		 Define una ubicación de almacenamiento de configuración por usuario.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds>
    $config.Put()    		 Establece el tiempo de espera de sincronización en milisegundos para todos los usuarios del equipo.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.MaxPackageSizeInBytes = <size_in_bytes>
    $config.Put()    		 Configura el agente de UE-V para informar cuando un tamaño de archivo de paquete de configuración alcanza un umbral definido. Establezca el tamaño del archivo de paquete de umbral en bytes para todos los usuarios del equipo.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SyncMethod = <sync_method>
    $config.Put()    		 Establece el método de sincronización para todos los usuarios del equipo: SyncProvider o None.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $true
    $config.Put()    		 Para habilitar una configuración específica por equipo, borre la configuración y use $null como valor de configuración. Use UserConfiguration para la configuración por usuario.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $false
    $config.Put()    		 Para deshabilitar una configuración específica por equipo, borre la configuración y use $null como valor de configuración. Use Configuración de usuario para la configuración por usuario.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 Actualiza una configuración específica por equipo. Para borrar la configuración, use $null como valor de configuración.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 Actualiza una configuración específica por usuario para todos los usuarios del equipo. Para borrar la configuración, use $null como valor de configuración.

Tras la configuración del agente de UE-V con WMI y Windows PowerShell, la configuración definida se almacena en el Registro en las siguientes ubicaciones.

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

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

Para exportar la configuración del paquete de UE-V y reparar plantillas de UE-V mediante WMI

  1. UE-V proporciona el siguiente conjunto de comandos WMI. Los administradores pueden usar esta interfaz para exportar un paquete o reparar plantillas de UE-V.

  2. Use los siguientes comandos WMI.

    Comando WMI Descripción
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserSettings -Name ExportPackage -ArgumentList <package name> Extrae la configuración de un archivo de paquete y las convierte en un formato legible en XML.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name RebuildIndex Repara el índice de las plantillas de ubicación de configuración de UE-V. Debe ejecutarse como administrador.

Administración de UE-V 2.1 SP1 con Windows PowerShell y WMI

Administración de UE-V 2.1 SP1