Compartir a través de

Administración de UE-V 2.x Agent y paquetes con Windows PowerShell y WMI

  • Artículo

Se aplica a: User Experience Virtualization 2.0, User Experience Virtualization 2.1

Puede usar Instrumental de administración de Windows (WMI) y Windows PowerShell para administrar el comportamiento de sincronización y configuración de Virtualización de experiencia de usuario de Microsoft (UE-V) 2.0, 2.1 y 2.1 SP1 Agent. Para obtener una lista completa de cmdlets de PowerShell de UE-V, consulte UE-V 2 Cmdlet Reference (Referencia de cmdlets de UE-V 2) (https://go.microsoft.com/fwlink/?LinkId=393495).

Para implementar UE-V Agent mediante Windows PowerShell

  1. Almacene temporalmente el archivo del programa de instalación de UE-V en un recurso compartido de red accesible.

    Nota

    Utilice AgentSetup.exe para implementar versiones de 32 y 64 bits de UE-V Agent. Hay disponibles versiones del instalador de Windows, AgentSetupx86.msi y AgentSetupx64.msi para ambas arquitecturas. Para desinstalar UE-V Agent más adelante utilizando el archivo de instalación, debe utilizar el mismo tipo de archivo.

  2. Use uno de los siguientes comandos de Windows PowerShell para instalar 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%

Para configurar UE-V Agent 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 uso del parámetro Computer, abra la ventana con una cuenta que tenga derechos de administrador.

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

    Comando de Windows PowerShell Descripción

    Get-UevConfiguration

    Obtiene la configuración efectiva de UE-V Agent. La configuración específica del usuario tiene prioridad sobre la configuración del equipo.

    Get-UevConfiguration - CurrentComputerUser

    Obtiene los valores de configuración de UE-V Agent únicamente para el usuario actual.

    Get-UevConfiguration -Computer

    Obtiene los valores de configuración de UE-V Agent para todos los usuarios del equipo.

    Get-UevConfiguration -Details

    Obtiene los detalles de cada valor de configuración. Muestra dónde está configurado el valor o si utiliza 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 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 de ayuda en Centro de configuración de empresa. Puede utilizarse cualquier protocolo de dirección URL.

    Set-UevConfiguration -Computer –EnableDontSyncWindows8AppSettings

    Configura UE-V Agent para que no sincronice las aplicaciones de Windows para todos los usuarios del equipo.

    Set-UevConfiguration -CurrentComputerUser – EnableDontSyncWindows8AppSettings

    Configura UE-V Agent para que no sincronice las aplicaciones de Windows para el usuario actual del equipo.

    Set-UevConfiguration -Computer –EnableFirstUseNotification

    Configura UE-V Agente para que muestre una notificación la primera vez que el agente se ejecuta para todos los usuarios del equipo.

    Set-UevConfiguration -Computer –DisableFirstUseNotification

    Configura UE-V Agent para que no muestre notificación la primera vez que el agente se ejecuta para todos los usuarios del equipo.

    Set-UevConfiguration -Computer –EnableSettingsImportNotify

    Configura UE-V Agent para que notifique a todos los usuarios del equipo cuando se retrasa la sincronización de configuración.

    Utilice el parámetro DisableSettingsImportNotify para deshabilitar la notificación.

    Set-UevConfiguration - CurrentComputerUser -EnableSettingsImportNotify

    Configura UE-V Agent para notificar al usuario actual cuando se retrasa la sincronización de configuración.

    Utilice el parámetro DisableSettingsImportNotify para deshabilitar la notificación.

    Set-UevConfiguration -Computer –EnableSyncUnlistedWindows8Apps

    Configura UE-V Agent para que sincronice todas las aplicaciones de Windows que no se deshabilitan explícitamente mediante la lista de aplicaciones de Windows para todos los usuarios del equipo. Para obtener más información, consulte "Get-UevAppxPackage" en Administrar plantillas de ubicación de configuración de UE-V 2.x mediante Windows PowerShell y WMI.

    Use el parámetro DisableSyncUnlistedWindows8Apps para configurar UE-V Agent para que solo sincronice las aplicaciones de Windows habilitadas explícitamente en la lista de aplicaciones de Windows.

    Set-UevConfiguration - CurrentComputerUser - EnableSyncUnlistedWindows8Apps

    Configura UE-V Agent para que sincronice todas las aplicaciones de Windows que no se deshabiliten explícitamente mediante la lista de aplicaciones de Windows para el usuario actual del equipo. Para obtener más información, consulte "Get-UevAppxPackage" en Administrar plantillas de ubicación de configuración de UE-V 2.x mediante Windows PowerShell y WMI.

    Use el parámetro DisableSyncUnlistedWindows8Apps para configurar UE-V Agent para que solo sincronice las aplicaciones de Windows habilitadas explícitamente en la lista de aplicaciones de Windows.

    Set-UevConfiguration –Computer –DisableSync

    Deshabilita UE-V para todos los usuarios del equipo.

    Utilice el parámetro EnableSync para habilitarlo o volver a habilitarlo.

    Set-UevConfiguration –CurrentComputerUser -DisableSync

    Deshabilita UE-V para el usuario actual del equipo.

    Utilice el parámetro EnableSync para habilitarlo o volver a habilitarlo.

    Set-UevConfiguration -Computer –EnableTrayIcon

    Habilita el icono UE-V en el área de notificación para todos los usuarios del equipo.

    Utilice el parámetro DisableTrayIcon para deshabilitar el icono.

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

    Configura UE-V Agent para que lo notifique cuando el tamaño de un archivo de paquete de configuración alcance el umbral definido para todos los usuarios del equipo. Establece el tamaño umbral de paquete en bytes.

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

    Configura UE-V Agent para que lo notifique cuando el tamaño de un archivo de paquete de configuración alcance 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 la notificación al usuario, para todos los usuarios del equipo

    Set-UevConfiguration - CurrentComputerUser -SettingsImportNotifyDelayInSeconds

    Especifica el tiempo en segundos que debe transcurrir 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 (ninguno).

    Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method>

    Establece el método de sincronización para el usuario actual: SyncProvider o None (ninguno).

    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 una configuración específica para todos los usuarios del equipo.

    Clear-UevConfiguration –CurrentComputerUser -<setting name>

    Borra una configuración específica únicamente para el usuario actual.

    Export-UevConfiguration <settings migration file>

    Exporta la configuración de UE-V del equipo a un archivo de migración de configuración. La extensión del nombre de archivo debe ser .uev.

    El cmdlet Export exporta toda la configuración de UE-V Agent que se puede configurar con el parámetro Computer.

    Import-UevConfiguration <settings migration file>

    Importa la configuración del equipo de UE-V desde un archivo de migración de configuración. La extensión del nombre de archivo debe ser .uev.

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

  1. Abra una ventana de Windows PowerShell como administrador.

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

    Windows PowerShell comando

    Descripción

    Export-UevPackage MicrosoftCalculator6.pkgx

    Extrae la configuración de un archivo de paquete de Microsoft Calculator y la 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 UE-V Agent mediante WMI

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

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

  2. Utilice los siguientes comandos de WMI para configurar el agente.

    Windows PowerShell command Descripción

    Get-WmiObject -Namespace root\Microsoft\UEV Configuration

    Muestra la configuración activa de UE-V Agent. 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 de UE-V Agent definida para un usuario.

    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    Muestra la configuración de UE-V Agent 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 UE-V Agent para que genere un informe cuando el tamaño de un archivo de paquete de configuración alcance un umbral definido. Establece el umbral del tamaño de archivo de paquete 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 (ninguno).

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

    $config.<setting name> = $true

    $config.Put()

    Para habilitar una configuración específica por equipo, desactive la configuración y utilice $null como valor del parámetro de configuración. Utilice UserConfiguration para llevar a cabo una configuración por usuario.

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

    $config.<setting name> = $false

    $config.Put()

    Para deshabilitar una configuración por equipo específica, borre el parámetro de configuración y utilice $null como valor del parámetro. Utilice UserConfiguration para llevar a cabo una configuración por usuario.

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

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

    $config.Put()

    Actualiza un parámetro de configuración por equipo específico. Para borrar la configuración, utilice $null como valor del parámetro.

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

    $config.<nombre de configuración< = >valor de configuración>

    $config.Put()

    Actualiza una configuración por usuario específica para todos los usuarios del equipo. Para borrar la configuración, utilice $null como valor del parámetro.

    Cuando se configura UE-V Agent 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 de paquete de UE-V y reparar las plantillas de UE-V mediante WMI

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

  2. Utilice los siguientes comandos de 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 la 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.

    ¿Tiene alguna sugerencia sobre UE-V? Agregue o vote sugerencias aquí. ¿
    Tiene un problema de UE-V? Use el foro de TechNet de UE-V.

Véase también

Otros recursos

Administrar UE-V 2.x con Windows PowerShell y WMI
Administración de UE-V 2.x