Administrar plantillas de ubicación de configuración de UE-V 2.x mediante Windows PowerShell y WMI

  • Artículo

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

Virtualización de experiencia de usuario de Microsoft (UE-V) 2.0, 2.1 y 2.1 SP1 usan plantillas de ubicación de configuración XML para definir las configuraciones que Virtualización de la experiencia del usuario captura y aplica. UE-V incluye un conjunto de plantillas de ubicación de configuración estándar. También incluye la herramienta UE-V Generator que le permite crear plantillas de ubicación de configuración personalizadas. Después de crear e implementar plantillas de ubicación de configuración, puede administrarlas mediante Windows PowerShell y Windows Management Instrumentation (WMI). Para obtener la lista completa de UE-V cmdlets de PowerShell, consulte UE-V 2 Cmdlet Reference (Referencia de cmdlets de UE-V 2) (https://go.microsoft.com/fwlink/p/?LinkId=393495).

Administrar plantillas de ubicación de configuración de UE-V 2 mediante Windows PowerShell

Las funciones de WMI y Windows PowerShell de UE-V tienen la capacidad de habilitar, deshabilitar, registrar, actualizar y anular el registro de plantillas de ubicación de configuración. Mediante estas funciones puede automatizar el proceso de registrar, actualizar o eliminar el registro de plantillas con UE-V Agent. También puede registrar manualmente las plantillas mediante comandos de WMI y Windows PowerShell. Mediante el uso de estas características junto con una solución de distribución electrónica de software, directiva de grupo u otro método de implementación automatizada (como un script), puede automatizar aún más el proceso.

Para actualizar, registrar o anular el registro de una plantilla de ubicación de configuración debe tener permisos de administrador. Los permisos de administrador no son necesarios para habilitar, deshabilitar o mostrar una lista de plantillas.

Para administrar plantillas de ubicación de configuración mediante Windows PowerShell

  1. Utilice una cuenta con derechos de administrador para abrir un símbolo del sistema de Windows PowerShell.

  2. Use los siguientes cmdlets de Windows PowerShell para registrar y administrar las plantillas de ubicación de configuración de UE-V.

    Comando de Windows PowerShell Descripción

    Get-UevTemplate

    Enumera todas las plantillas de ubicación de configuración registradas en el equipo.

    Get-UevTemplate –Application <string>

    Enumera todas las plantillas de ubicación de configuración registradas en el equipo en las que el nombre de la aplicación o el nombre de la plantilla contenga <cadena>.

    Get-UevTemplate –TemplateID <string>

    Enumera todas las plantillas de ubicación de configuración registradas en el equipo cuyo identificador de plantilla contenga <cadena>.

    Get-UevTemplate [-ApplicationOrTemplateID] <string>

    Enumera todas las plantillas de ubicación de configuración registradas en el equipo en las que el nombre de la aplicación o de la plantilla o el identificador de plantilla contengan <cadena>.

    Get-UevTemplateProgram [-ID] <template ID>

    Obtiene el nombre del programa e información de la versión, que dependen del identificador de plantilla.

    Get-UevAppXPackage

    Obtiene la lista real de aplicaciones de Windows.

    Get-UevAppXPackage -Computer

    Obtiene la lista de aplicaciones de Windows configuradas para el equipo.

    Get-UevAppXPackage -CurrentComputerUser

    Obtiene la lista de aplicaciones de Windows configuradas para el usuario actual.

    Register-UevTemplate [-Path] <template file path>[,<template file path>]

    Registra una o más plantillas de ubicación de configuración con UE-V mediante el uso de rutas de acceso relativas o caracteres comodín en las rutas de acceso de archivo. Después de registrar una plantilla, UE-V sincroniza la configuración definida en la plantilla entre los equipos que tienen la plantilla registrada.

    Register-UevTemplate –LiteralPath <template file path>[,<template file path>]

    Registra una o más plantillas de ubicación de configuración con UE-V mediante rutas de acceso literales, en donde los caracteres no se pueden interpretar como caracteres comodín. Después de registrar una plantilla, UE-V sincroniza la configuración definida en la plantilla entre los equipos que tienen la plantilla registrada.

    Unregister-UevTemplate [-ID] <template ID>

    Anula el registro de una plantilla de ubicación de configuración con UE-V. Cuando se anula el registro de una plantilla, UE-V ya no sincroniza entre los equipos las opciones de configuración que se definen en la plantilla.

    Unregister-UevTemplate -All

    Anula el registro de todas las plantillas de ubicación de configuración con UE-V. Cuando se anula el registro de una plantilla, UE-V ya no sincroniza entre los equipos las opciones de configuración que se definen en la plantilla.

    Update-UevTemplate [-Path] <template file path>[,<template file path>]

    Actualiza una o varias plantillas de ubicación de configuración con una versión más reciente de la plantilla. Utilice rutas de acceso relativas o caracteres comodín en las rutas de acceso de archivo. La versión de la nueva plantilla debe ser más reciente que la de la plantilla existente.

    Update-UevTemplate –LiteralPath <template file path>[,<template file path>]

    Actualiza una o varias plantillas de ubicación de configuración con una versión más reciente de la plantilla. Use rutas de acceso completas a los archivos de plantilla, donde los caracteres no se pueden interpretar como caracteres comodín. La versión de la nueva plantilla debe ser más reciente que la de la plantilla existente.

    Clear-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]

    Quita una o más aplicaciones de Windows de la lista de aplicaciones de Windows del equipo.

    Clear-UevAppXPackage -CurrentComputerUser

    Quita la aplicación de Windows de la lista de aplicaciones de Windows del usuario actual.

    Clear-UevAppXPackage –Computer -All

    Quita todas las aplicaciones de Windows de la lista de aplicaciones de Windows del equipo.

    Clear-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]

    Quita una o más aplicaciones de Windows de la lista de aplicaciones de Windows del usuario actual.

    Clear-UevAppXPackage [–CurrentComputerUser] -All

    Quita todas las aplicaciones de Windows de la lista de aplicaciones de Windows del usuario actual.

    Disable-UevTemplate [-ID] <template ID>

    Deshabilita una plantilla de ubicación de configuración para el usuario actual del equipo.

    Disable-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]

    Deshabilita una o más aplicaciones de Windows en la lista de aplicaciones de Windows del equipo.

    Disable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]

    Deshabilita una o más aplicaciones de Windows en la lista de aplicaciones Windows del usuario actual.

    Enable-UevTemplate [-ID] <template ID>

    Habilita una plantilla de ubicación de configuración para el usuario actual del equipo.

    Enable-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]

    Habilita una o más aplicaciones de Windows en la lista de aplicaciones de Windows del equipo.

    Enable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]

    Habilita una o más aplicaciones de Windows en la lista de aplicaciones Windows del usuario actual.

    Test-UevTemplate [-Path] <template file path>[,<template file path>]

    Determina si una o varias plantillas de ubicación de configuración están conformes con su esquema XML. Se pueden utilizar rutas de acceso relativas y caracteres comodín.

    Test-UevTemplate –LiteralPath <template file path>[,<template file path>]

    Determina si una o varias plantillas de ubicación de configuración están conformes con su esquema XML. La ruta de acceso debe ser una ruta de acceso completa al archivo de plantilla, pero no incluye caracteres comodín.

Las funciones de Windows PowerShell de UE-V le permiten administrar un grupo de plantillas de configuración implementadas en su empresa. Use el procedimiento siguiente para administrar un grupo de plantillas mediante Windows PowerShell.

Para administrar un grupo de plantillas de ubicación de configuración mediante Windows PowerShell

  1. Modifique o actualice las plantillas de ubicación de configuración deseadas.

  2. Si desea modificar o actualizar las plantillas de ubicación de configuración, sitúelas en una carpeta que sea accesible para el equipo local.

  3. En el equipo local, abra una ventana de Windows PowerShell con derechos de administrador.

  4. Anule el registro de todas las versiones previamente registradas de las plantillas escribiendo el siguiente comando.

    Unregister-UevTemplate -All

    Este comando anula el registro de todas las plantillas activas en el equipo.

  5. Registre las plantillas actualizadas escribiendo el siguiente comando.

    Register-UevTemplate <path to template folder>\*.xml

    Este comando registra todas las plantillas de ubicación de configuración ubicadas en la carpeta de plantillas especificada.

Lista de aplicaciones de Windows

Al incluir una aplicación de Windows en la lista de aplicaciones de Windows, se especifica si dicha aplicación tiene la sincronización de configuración habilitada o deshabilitada. Las aplicaciones se identifican en función del nombre de familia del paquete y de si tiene la sincronización de configuración habilitada o deshabilitada. Si usa esta configuración junto con la opción de comportamiento de sincronización predeterminado sin enumerar, puede determinar si las aplicaciones de Windows se sincronizan.

Para mostrar el nombre de familia del paquete de aplicaciones de Windows instaladas, en un símbolo del sistema de Windows PowerShell, escriba:

Get-AppxPackage | Sort-Object PackageFamilyName | Format-Table PackageFamilyName

Para mostrar una lista de las aplicaciones de Windows que pueden sincronizar la configuración en un equipo con el nombre de familia del paquete, el estado habilitado y el origen habilitado, escriba en un símbolo del sistema de Windows PowerShell: Get-UevAppxPackage

Definiciones de las propiedades de Get-UevAppxPackage

  • DisplayName
    Nombre que se muestra al usuario en la aplicación Centro de configuración de empresa. La propiedad DisplayName se deriva de la propiedad PackageFamilyName.
  • PackageFamilyName
    Nombre del paquete instalado para el usuario actual.
  • Habilitada
    Define si la configuración de la aplicación está establecida para sincronizar.
  • EnabledSource
    Ubicación donde está establecida la configuración que habilita o deshabilita la aplicación. Los valores posibles son: NotSet, LocalMachine, LocalUser, PolicyMachine y PolicyUser.
  • NotSet
    La directiva no está configurada para sincronizar esta aplicación.
  • LocalMachine
    El estado habilitado se establece en la sección del equipo local del Registro.
  • LocalUser
    El estado habilitado se establece en la sección del usuario actual del Registro.
  • PolicyMachine
    El estado habilitado se establece en la sección de directiva de la sección del equipo local del Registro.

Para obtener la lista de aplicaciones de Windows configurada por el usuario, en el símbolo del sistema de Windows PowerShell, escriba: Get-UevAppxPackage –CurrentComputerUser

Para obtener la lista de aplicaciones de Windows configurada por el equipo, en el símbolo del sistema de Windows PowerShell, escriba: Get-UevAppxPackage –Computer

Para ambos parámetros, CurrentComputerUser o Computer, el cmdlet devuelve una lista de las aplicaciones de Windows que están configuradas en el nivel del usuario o del equipo.

Definiciones de las propiedades

  • DisplayName
    Nombre que se muestra al usuario en la aplicación Centro de configuración de empresa. La propiedad DisplayName se deriva de la propiedad PackageFamilyName.
  • PackageFamilyName
    Nombre del paquete instalado para el usuario actual.
  • Habilitada
    Define si la configuración de la aplicación está establecida para sincronizar para el conmutador especificado, es decir, user o computer.
  • Installed
    Verdadero si la aplicación, es decir, PackageFamilyName, está instalada para el usuario actual.

Administrar plantillas de ubicación de configuración de UE-V 2 mediante WMI

Virtualización de la experiencia del usuario proporciona el siguiente conjunto de comandos de WMI. Los administradores pueden usar estas interfaces para administrar plantillas de ubicación de configuración desde Windows PowerShell y automatizar tareas administrativas de plantillas.

Para administrar plantillas de ubicación de configuración mediante WMI

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

  2. Utilice los siguientes comandos de WMI para registrar y administrar las plantillas de ubicación de configuración de UE-V.

    Windows PowerShell command Descripción

    Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate | Select-Object TemplateId,TemplateName, TemplateVersion,Enabled | Format-Table -Autosize

    Enumera todas las plantillas de ubicación de configuración registradas en el equipo.

    Invoke-WmiMethod –Namespace root\Microsoft\UEV –Class SettingsLocationTemplate –Name GetProcessInfoByTemplateId <template Id>

    Obtiene el nombre del programa e información de la versión, que dependen del nombre de la plantilla.

    Get-WmiObject -Namespace root\Microsoft\UEV EffectiveWindows8App

    Obtiene la lista real de aplicaciones de Windows.

    Get-WmiObject -Namespace root\Microsoft\UEV MachineConfiguredWindows8App

    Obtiene la lista de aplicaciones de Windows configuradas para el equipo.

    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguredWindows8App

    Obtiene la lista de aplicaciones de Windows configuradas para el usuario actual.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Register -ArgumentList <template path >

    Registra una plantilla de ubicación de configuración con UE-V.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name UnregisterByTemplateId -ArgumentList <template ID>

    Anula el registro de una plantilla de ubicación de configuración con UE-V. Cuando se anula el registro de una plantilla, UE-V ya no sincroniza entre los equipos las opciones de configuración que se definen en la plantilla.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList <template path>

    Actualiza una plantilla de ubicación de configuración con UE-V. La versión de la nueva plantilla debe ser más reciente que la de la plantilla existente.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name | package family name>

    Quita una o más aplicaciones de Windows de la lista de aplicaciones de Windows del equipo.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name | package family name>

    Quita una o más aplicaciones de Windows de la lista de aplicaciones de Windows del usuario actual.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name DisableByTemplateId -ArgumentList <template ID>

    Deshabilita una o varias plantillas de ubicación de configuración con UE-V.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name DisableApp -ArgumentList <package family name | package family name>

    Deshabilita una o más aplicaciones de Windows en la lista de aplicaciones de Windows del equipo.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name DisableApp -ArgumentList <package family name | package family name>

    Deshabilita una o más aplicaciones de Windows en la lista de aplicaciones Windows del usuario actual.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name EnableByTemplateId -ArgumentList <template ID>

    Habilita una plantilla de ubicación de configuración con UE-V.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name EnableApp -ArgumentList <package family name | package family name>

    Habilita aplicaciones de Windows en la lista de aplicaciones de Windows del equipo.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <package family name | package family name>

    Habilita aplicaciones de Windows en la lista de aplicaciones de Windows del usuario actual.

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList <template path>

    Determina si una plantilla de ubicación de configuración determinada cumple con su esquema XML.

    Nota

    Cuando el comando de WMI llama a una lista de nombres de familia de paquete, la lista debe estar entre comillas y sus elementos separados por una barra vertical, por ejemplo, "<package family name | package family name>".

Implementar UE-V Agent con Windows PowerShell

Cómo implementar UE-V Agent mediante Windows PowerShell

  1. Almacene temporalmente el paquete de instalación de UE-V Agent 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 Windows Installer, 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%

¿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