Administración de plantillas de ubicación de configuración de UE-V mediante el uso de Windows PowerShell y WMI

  • Artículo
  • Se aplica a:
    ✅ Windows 10

La virtualización de experiencia de usuario (UE-V) usa plantillas de ubicación de configuración XML para definir la configuración que la virtualización de experiencia de usuario captura y aplica. UE-V incluye un conjunto de plantillas de ubicación de configuración estándar. También incluye la herramienta generador de plantillas de UE-V 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 instrumental de administración de Windows (WMI).

Nota

Para obtener una lista completa de los cmdlets de UE-V, consulte Virtualización de la experiencia del usuario en Windows PowerShell.

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

Las características WMI y Windows PowerShell de UE-V incluyen la capacidad de habilitar, deshabilitar, registrar, actualizar y anular el registro de plantillas de ubicación de configuración. Con estas características, puede automatizar el proceso de registro, actualización o anulación del registro de plantillas con el servicio UE-V. También puede registrar plantillas manualmente mediante wmi y comandos de Windows PowerShell. Mediante el uso de estas características junto con una solución de distribución de software electrónico, directiva de grupo u otro método de implementación automatizado, como un script, puede automatizar aún más ese proceso.

Debe tener permisos de administrador para actualizar, registrar o anular el registro de una plantilla de ubicación de configuración. No se necesitan permisos de administrador para habilitar, deshabilitar o enumerar plantillas.

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

  1. Use una cuenta con derechos de administrador para abrir un símbolo del sistema 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 Listas todas las plantillas de ubicación de configuración que están registradas en el equipo.
    Get-UevTemplate -Application <string> Listas todas las plantillas de ubicación de configuración que están registradas en el equipo donde contiene el nombre de la aplicación o el nombre de la plantilla.
    Get-UevTemplate -TemplateID <string> Listas todas las plantillas de ubicación de configuración que están registradas en el equipo donde contiene el identificador de plantilla.
    Get-UevTemplate [-ApplicationOrTemplateID] <string> Listas todas las plantillas de ubicación de configuración que están registradas en el equipo donde contiene el nombre de la aplicación o plantilla, o el identificador de plantilla.
    Get-UevTemplateProgram [-ID] <template ID> Obtiene el nombre del programa y la información de versión, que dependen del identificador de plantilla.
    Get-UevAppXPackage Obtiene la lista efectiva 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 varias plantillas de ubicación de configuración con UE-V mediante rutas de acceso relativas o caracteres comodín en las rutas de acceso de archivo. Una vez registrada una plantilla, UE-V sincroniza la configuración definida en la plantilla entre los equipos que tienen registrada la plantilla.
    Register-UevTemplate -LiteralPath <template file path>[,<template file path>] Registra una o varias plantillas de ubicación de configuración con UE-V mediante rutas de acceso literales, donde no se puede interpretar ningún carácter como caracteres comodín. Una vez registrada una plantilla, UE-V sincroniza la configuración definida en la plantilla entre los equipos que tienen registrada la plantilla.
    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 la configuración definida en la plantilla entre equipos.
    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 la configuración definida en la plantilla entre equipos.
    Update-UevTemplate [-Path] <template file path>[,<template file path>] Novedades una o varias plantillas de ubicación de configuración con una versión más reciente de la plantilla. Use rutas de acceso relativas o caracteres comodín en las rutas de acceso del archivo. La nueva plantilla debe ser una versión más reciente que la existente.
    Update-UevTemplate -LiteralPath <template file path>[,<template file path>] Novedades 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 ningún carácter se puede interpretar como caracteres comodín. La nueva plantilla debe ser una versión más reciente que la existente.
    Clear-UevAppXPackage -Computer [-PackageFamilyName] <package family name>[,<package family name>] Quita una o varias 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 varias 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 varias 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 varias aplicaciones de Windows en la lista de aplicaciones de 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 varias 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 varias aplicaciones de Windows en la lista de aplicaciones de 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 cumplen con su esquema XML. Puede usar 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 cumplen 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 características de Windows PowerShell de UE-V permiten administrar un grupo de plantillas de configuración que se implementan en la 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, implemente esas plantillas de ubicación de configuración en una carpeta 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 registradas anteriormente 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 que se encuentran en la carpeta de plantillas especificada.

Lista de aplicaciones de Windows

Al enumerar una aplicación de Windows en la lista de aplicaciones de Windows, se especifica si esa aplicación está habilitada o deshabilitada para la sincronización de la configuración. Las aplicaciones se identifican en la lista por su nombre de familia de paquetes y si la sincronización de configuración debe estar habilitada o deshabilitada para esa aplicación. Al usar esta configuración junto con la configuración Comportamiento de sincronización predeterminado no publicado, puede controlar si las aplicaciones de Windows están sincronizadas.

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

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

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

Definiciones de propiedades de Get-UevAppxPackage

PackageFamilyName

Nombre del paquete instalado para el usuario actual.

Habilitado

Define si la configuración de la aplicación está configurada para sincronizarse.

EnabledSource

Ubicación en la que se establece 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 equipo local del Registro.

LocalUser

El estado habilitado se establece en la sección de usuario actual del Registro.

PolicyMachine

El estado habilitado se establece en la sección directiva de la sección equipo local del Registro.

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

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

Para cualquiera de los parámetros, CurrentComputerUser o Computer, el cmdlet devuelve una lista de las aplicaciones de Windows configuradas en el usuario o en el nivel de equipo.

Definiciones de propiedades

PackageFamilyName

Nombre del paquete instalado para el usuario actual.

Habilitado

Define si la configuración de la aplicación está configurada para sincronizarse con el conmutador especificado, es decir, el usuario o el equipo.

Instalado

True si la aplicación, es decir, PackageFamilyName está instalada para el usuario actual.

Administración de plantillas de ubicación de configuración de UE-V mediante WMI

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

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

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

  2. Use los siguientes comandos 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 Listas todas las plantillas de ubicación de configuración que están registradas para el equipo.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name GetProcessInfoByTemplateId <template Id> Obtiene el nombre del programa y la información de versión, que depende del nombre de la plantilla.
    Get-WmiObject -Namespace root\Microsoft\UEV EffectiveWindows8App Obtiene la lista efectiva 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. En cuanto se anula el registro de una plantilla, UE-V ya no sincroniza la configuración definida en la plantilla entre equipos.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList <template path> Novedades una plantilla de ubicación de configuración con UE-V. La nueva plantilla debe ser una versión más reciente que la existente.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name> Quita una o varias 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> Quita una o varias 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> Deshabilita una o varias 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> Deshabilita una o varias aplicaciones de Windows en la lista de aplicaciones de 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> Habilita las 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> Habilita las 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 WMI llama a una lista de nombres de familia de paquetes, la lista debe estar entre comillas y estar separada por un símbolo de canalización, por ejemplo, "<package family name | package family name>".

Administración de UE-V con Windows PowerShell y WMI Administración de la virtualización de experiencia de usuario de UE-V en Windows PowerShell