Compartir a través de

Administración de plantillas de ubicación de configuración de UE-V 2.1 SP1 mediante Windows PowerShell y WMI

  • Artículo

Microsoft User Experience Virtualization (UE-V) 2.1 SP1 usa plantillas de ubicación de configuración XML para definir la configuración que UE-V 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 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). Para obtener una lista completa de los cmdlets de PowerShell de UE-V, consulte Referencia de cmdlets MDOP.

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

Las características de 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 agente de UE-V. También puede registrar manualmente las plantillas mediante los comandos WMI y Windows PowerShell. Al usar estas características con una solución de distribución de software electrónico, una 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 requieren 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 de Windows PowerShell.

  2. Para registrar y administrar las plantillas de ubicación de configuración de UE-V, use los siguientes cmdlets de Windows PowerShell:

    Comando de Windows PowerShell Descripción
    Get-UevTemplate Enumera todas las plantillas de ubicación de configuración que están registradas en el equipo.
    Get-UevTemplate -Application <string> Enumera todas las plantillas de ubicación de configuración que están registradas en el equipo donde el nombre de la aplicación o el nombre de plantilla contiene <string>.
    Get-UevTemplate -TemplateID <string> Enumera todas las plantillas de ubicación de configuración que están registradas en el equipo donde el identificador de plantilla contiene <string>.
    Get-UevTemplate [-ApplicationOrTemplateID] <string> Enumera todas las plantillas de ubicación de configuración que están registradas en el equipo donde el nombre de la aplicación o plantilla, o el identificador de plantilla contiene <string>.
    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>] 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 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>] 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 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 de Windows PowerShell, escriba lo siguiente:

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 de Windows PowerShell, escriba lo siguiente: Get-UevAppxPackage

Definiciones de propiedades de Get-UevAppxPackage

  • DisplayName: nombre que se muestra al usuario en la aplicación Centro de configuración de empresa. La DisplayName propiedad se deriva de la PackageFamilyName propiedad .

  • PackageFamilyName: nombre del paquete que está instalado para el usuario actual.

  • Habilitado: define si la configuración de la aplicación está configurada para sincronizarse.

  • EnabledSource: la ubicación donde 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 de directiva de la sección equipo local del Registro.

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

Para obtener la lista configurada por el equipo de aplicaciones de Windows, en el símbolo del sistema de Windows PowerShell, escriba lo siguiente: 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

  • DisplayName: nombre que se muestra al usuario en la aplicación Centro de configuración de empresa. La DisplayName propiedad se deriva de la PackageFamilyName propiedad .

  • PackageFamilyName: nombre del paquete que está 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 PackageFamilyName está instalado para el usuario actual.

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

UE-V 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.

  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.

    Comando de Windows PowerShell 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 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> Actualiza 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 \ | 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 \ | 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 \ | 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 \ | 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 \ | 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 \ | 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>".

Implementación del agente de UE-V mediante Windows PowerShell

  1. Almacene provisionalmente el paquete de instalación del agente 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%

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

Administración de UE-V 2.1 SP1