Administración de UE-V 1.0 Agent y paquetes de UE-V con PowerShell y WMI
Se aplica a: User Experience Virtualization 1.0
Puede utilizar WMI y PowerShell para administrar la configuración y el comportamiento de sincronización de Microsoft User Experience Virtualization (UE-V) Agent.
Cómo implementar UE-V Agent con PowerShell
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 de del instalador de Windows para ambas arquitecturas, AgentSetupx86.msi y AgentSetupx64.msi. Para desinstalar UE-V Agent más adelante utilizando el archivo de instalación, debe utilizar el mismo tipo de archivo.
Utilice uno de los siguientes comandos de PowerShell para instalar el agente.
& 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%
Cómo configurar UE-V Agent con PowerShell
Utilice una cuenta con derechos de administrador para abrir una ventana de PowerShell. Importe el módulo de PowerShell de UE-V mediante el comando siguiente.
Import-module UEV
Utilice los siguientes comandos de PowerShell para configurar el agente.
Comando de PowerShell
Descripción
Get-UevConfiguration
Permite ver la configuración de UE-V Agent vigente. La configuración específica del usuario tiene prioridad sobre la configuración del equipo.
Get-UevConfiguration - CurrentComputerUser
Permite ver los valores de configuración de UE-V Agent para el usuario actual solamente.
Get-UevConfiguration -Computer
Permite ver los valores de configuración de UE-V Agent para todos los usuarios del equipo.
Set-UevConfiguration -Computer -SettingsStoragePath <ruta de acceso para _ubicación_almacenamiento_de_configuración>
Permite definir una ubicación de almacenamiento de configuración por equipo.
Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <ruta de acceso para _ubicación_almacenamiento_de_configuración>
Define una ubicación de almacenamiento de configuración por usuario.
Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <tiempo de espera en milisegundos>
Establece el tiempo de espera de sincronización en milisegundos
Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <tiempo de espera en milisegundos>
Establece el tiempo de espera de sincronización para el usuario actual.
Set-UevConfiguration -Computer -MaxPackageSizeInBytes <tamaño en bytes>
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 tamaño umbral de paquete en bytes.
Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <tamaño en bytes>
Establece el umbral de advertencia de tamaño de paquete para el usuario actual.
Set-UevConfiguration –Computer –SettingsTemplateCatalogPath <ruta de acceso del catálogo>
Establece la ruta de acceso del catálogo de plantillas de configuración.
Set-UevConfiguration -Computer -SyncMethod <método de sincronización>
Establece el método de sincronización: OfflineFiles o None.
Set-UevConfiguration -CurrentComputerUser -SyncMethod <método de sincronización>
Establece el método de sincronización para el usuario actual: OfflineFiles o None.
Set-UEVConfiguration -Computer –EnableSettingsImportNotify
Habilita que se genere una notificación cuando se retrasa la importación de configuración del usuario.
Use –DisableSettingsImportNotify para deshabilitar la notificación.
Set-UEVConfiguration - CurrentComputerUser -EnableSettingsImportNotify
Habilita la notificación para el usuario actual cuando se retrasa la importación de la configuración del usuario.
Use –DisableSettingsImportNotify para deshabilitar la notificación.
Set-UEVConfiguration -Computer -SettingsImportNotifyDelayInSeconds
Especifica el tiempo en segundos que debe transcurrir antes de que se notifique al usuario
Set-UEVConfiguration - CurrentComputerUser -SettingsImportNotifyDelayInSeconds
Especifica el tiempo en segundos que debe transcurrir antes de que se genere la notificación para el usuario actual.
Set-UevConfiguration –Computer –DisableSync
Deshabilita UE-V para todos los usuarios del equipo.
Use –EnableSync para habilitarlo o volver a habilitarlo.
Set-UevConfiguration –CurrentComputerUser -DisableSync
Deshabilita UE-V para el usuario actual del equipo.
Use –EnableSync para habilitarlo o volver a habilitarlo.
Clear-UevConfiguration –Computer -<nombre de configuración>
Borra una configuración específica para todos los usuarios del equipo.
Clear-UevConfiguration –CurrentComputerUser -<nombre de configuración>
Borra una configuración específica para el usuario actual solamente.
Export-UevConfiguration <archivo de migración de configuración>
Exporta la configuración del equipo con UE-V a un archivo de configuración de migración. La extensión del archivo debe ser “.uev”.
El cmdlet de exportación exporta todas las opciones de configuración de UE-V Agent que pueden configurarse mediante el parámetro -computer.
Import-UevConfiguration <archivo de migración de configuración>
Importa la configuración del equipo de UE-V desde un archivo de migración de configuración (archivo .uev).
Cómo exportar la configuración de paquete de UE-V y reparar las plantillas de UE-V con PowerShell
Abra una ventana de PowerShell como administrador. Importe el módulo de PowerShell de UE-V con el siguiente comando.
Import-module UEV
Utilice los siguientes comandos de PowerShell para configurar el agente.
Comando de PowerShell
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.
Cómo configurar UE-V Agent con WMI
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 PowerShell.
Utilice los siguientes comandos de WMI para configurar el agente.
Comando de PowerShell Descripción Get-WmiObject -Namespace root\Microsoft\UEV Configuration
Permite ver la configuración activa 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
Permite ver la configuración de UE-V Agent definida por el usuario.
Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
Permite ver la configuración del agente UE-V definida para el equipo.
$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
$config.SettingsStoragePath = <ruta_de_acceso_a_ubicación_de_almacenamiento_de_configuración>
$config.Put()
Permite definir una ubicación de almacenamiento de configuración por equipo.
$config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration
$config.SettingsStoragePath = <ruta_de_acceso_a_ubicación_de_almacenamiento_de_configuración>
$config.Put()
Define una ubicación de almacenamiento de configuración por usuario.
$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
$config.SyncTimeoutInMilliseconds = <tiempo_de_espera_en_milisegundos>
$config.Put()
Establece el tiempo de espera de sincronización en milisegundos.
$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
$config.MaxPackageSizeInBytes = <tamaño_en_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 tamaño umbral de archivo de paquete en bytes.
$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
$config.SyncMethod = <método_de_sincronización>
$config.Put()
Establece el método de sincronización: OfflineFiles o None.
$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
$config.<nombre de configuración> = <valor de configuración>
$config.Put()
Actualiza una configuración de equipo específica. Para borrar la configuración, use $null como valor de configuración.
$config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
$config.<nombre de configuración> = <valor de configuración>
$config.Put()
Actualiza una configuración de usuario específica. Para borrar la configuración, use $null como valor de configuración.
Cuando se configura UE-V Agent con WMI y 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
Vea también
Otros recursos
Administración de UE-V 1.0
Operaciones para UE-V 1.0
-----
Puede obtener más información acerca de Microsoft Desktop Optimization Pack (MDOP) en la biblioteca de TechNet, en la sección de solución de problemas de TechNet Wiki, o bien a través de Facebook o Twitter.
-----