Gerenciando modelos do local das configurações do UE-V 2.x usando o Windows PowerShell e o WMI

  • Artigo

Aplica-se a: User Experience Virtualization 2.0, User Experience Virtualization 2.1

O Microsoft User Experience Virtualization (UE-V) 2.0, 2.1 e 2.1 SP1 usam modelos de local de configurações XML para definir as configurações que o Virtualização da Experiência do Usuário captura e aplica. O UE-V inclui um conjunto de modelos padrão de local de configurações. Ele também inclui a ferramenta gerador do UE-V que permite criar modelos de local de configuração personalizados. Depois de criar e implantar modelos de local de configurações, você pode gerenciar esses modelos usando o Windows PowerShell e o Windows Management Instrumentation (WMI). Para obter uma lista completa de cmdlets do PowerShell do UE-V, consulte a Referência de Cmdlet do UE-V 2 (https://go.microsoft.com/fwlink/p/?LinkId=393495).

Gerenciar modelos de local de configurações do UE-V 2 usando o Windows PowerShell

O WMI e os recursos do Windows PowerShell de UE-V incluem a capacidade de habilitar, desabilitar, registrar, atualizar e cancelar o registro de modelos de local de configurações. Ao usar esses recursos, você pode automatizar o processo de registro, atualização ou cancelamento do registro de modelos com o agente do UE-V. Você pode registrar manualmente os modelos usando comandos do WMI e do Windows PowerShell. Ao usar esses recursos em conjunto com uma solução de distribuição eletrônica de software, política de grupo ou outro método de implantação automatizado como um script, você pode automatizar ainda mais esse processo.

Você deve ter permissões de administrador para atualizar, registrar ou cancelar o registro de um modelo de configurações do local. Permissões de administrador não são necessárias para habilitar, desabilitar ou listar modelos.

Gerenciar modelos de local de configurações usando o Windows PowerShell

  1. Use uma conta com direitos de administrador para abrir um prompt de comandos do Windows PowerShell.

  2. Use os seguintes cmdlets Windows PowerShell para registrar e gerenciar os modelos de local de configurações do UE-V.

    Comando Windows PowerShell Descrição

    Get-UevTemplate

    Lista todos os modelos de local de configurações que são registrados no computador.

    Get-UevTemplate –Application <string>

    Lista todos os modelos de local de configurações que estão registrados no computador onde o nome do aplicativo ou o nome do modelo contém <string>.

    Get-UevTemplate –TemplateID <string>

    Lista todos os modelos de local de configurações que estão registrados no computador em que a ID do modelo contém <string>.

    Get-UevTemplate [-ApplicationOrTemplateID] <string>

    Lista todos os modelos de local de configurações que estão registrados no computador onde o aplicativo ou o nome do modelo ou a ID do modelo contém <string>.

    Get-UevTemplateProgram [-ID] <template ID>

    Obtém o nome das informações de versão e o programa, que dependem da ID do modelo.

    Get-UevAppXPackage

    Obtém a lista efetiva de aplicativos do Windows.

    Get-UevAppXPackage -Computer

    Obtém a lista de aplicativos do Windows que estão configurados para o computador.

    Get-UevAppXPackage -CurrentComputerUser

    Obtém a lista de aplicativos do Windows que estão configurados para o usuário atual.

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

    Registra uma ou mais configurações local modelo com o UE-V usando caminhos relativos e/ou caracteres curinga em caminhos de arquivo. Depois que um modelo é registrado, o UE-V sincroniza as configurações que são definidas no modelo entre computadores que têm o modelo registrado.

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

    Registra uma ou mais configurações local modelo com o UE-V usando caminhos literais, onde nenhum caractere pode ser interpretado como caracteres curinga. Depois que um modelo é registrado, o UE-V sincroniza as configurações que são definidas no modelo entre computadores que têm o modelo registrado.

    Unregister-UevTemplate [-ID] <template ID>

    Cancela o registro de um modelo de localização de configurações com o UE-V. Quando um modelo é cancelado, o UE-V não sincroniza as configurações que são definidas no modelo entre computadores.

    Unregister-UevTemplate -All

    Cancela o registro de todos os modelos de local de configurações com o UE-V. Quando um modelo é cancelado, o UE-V não sincroniza as configurações que são definidas no modelo entre computadores.

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

    Atualiza um ou mais modelos de local de configurações com uma versão mais recente do modelo. Use caminhos relativos e/ou caracteres curinga em caminhos de arquivo. O novo modelo deve ser uma versão mais recente que o modelo existente.

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

    Atualiza um ou mais modelos de local de configurações com uma versão mais recente do modelo. Use caminhos completos para arquivos de modelo, onde nenhum caractere pode ser interpretado como caracteres curinga. O novo modelo deve ser uma versão mais recente que o modelo existente.

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

    Remove um ou mais aplicativos do Windows da lista de aplicativos do Windows do computador.

    Clear-UevAppXPackage -CurrentComputerUser

    Remove o aplicativo do Windows da lista atual de aplicativos do Windows do usuário.

    Clear-UevAppXPackage –Computer -All

    Remove todos os aplicativos do Windows da lista de aplicativos do Windows do computador.

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

    Remove um ou mais aplicativos do Windows da lista atual de aplicativos do Windows do usuário.

    Clear-UevAppXPackage [–CurrentComputerUser] -All

    Remove todos os aplicativos do Windows da lista atual de aplicativos do Windows do usuário.

    Disable-UevTemplate [-ID] <template ID>

    Desabilita um modelo de localização de configurações para o usuário atual do computador.

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

    Desabilita um ou mais aplicativos do Windows da lista de aplicativos do Windows do computador.

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

    Desabilita um ou mais aplicativos do Windows da lista atual de aplicativos do Windows do usuário.

    Enable-UevTemplate [-ID] <template ID>

    Habilita um modelo de localização de configurações para o usuário atual do computador.

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

    Habilita um ou mais aplicativos do Windows da lista de aplicativos do Windows do computador.

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

    Habilita um ou mais aplicativos do Windows da lista atual de aplicativos do Windows do usuário.

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

    Determina se um ou mais modelos de local de configurações estão de acordo com seu esquema XML. Pode usar caminhos relativos e caracteres curinga.

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

    Determina se um ou mais modelos de local de configurações estão de acordo com seu esquema XML. O caminho deve ser um caminho completo para o arquivo de modelo, mas não incluir caracteres curinga.

Os recursos do Windows PowerShell do UE-V permitem gerenciar um grupo de modelos de configurações que são implantados na sua empresa. Use o procedimento a seguir para gerenciar um grupo de modelos usando o Windows PowerShell.

Para gerenciar um grupo de modelos de local de configurações usando o Windows PowerShell

  1. Modificar ou atualizar os modelos de local de configurações desejadas.

  2. Se você quiser modificar ou atualizar os modelos de local de configurações, implante essas modelos de configurações de local para uma pasta que seja acessível ao computador local.

  3. No computador local, abra uma janela do Windows PowerShell com direitos de administrador.

  4. Cancelar o registro de todas as versões previamente registradas dos modelos, digitando o comando a seguir.

    Unregister-UevTemplate -All

    Esse comando cancela o registro de todos os modelos ativos no computador.

  5. Registre os modelos atualizados, digitando o comando a seguir.

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

    Esse comando registra todos os modelos de local de configurações que estão localizados na pasta do modelo especificado.

Lista de aplicativos do Windows

Ao relacionar um aplicativo do Windows na lista de aplicativos do Windows, você especifica se esse aplicativo está habilitado ou desabilitado para a sincronização de configurações. Os aplicativos são identificados na lista por seu nome de Família de Pacotes e se a sincronização de configurações deve estar habilitada ou desabilitada para esse aplicativo. Ao usar essas configurações junto com a configuração Comportamento da Sincronização Padrão Não Relacionado, você pode controlar se os aplicativos do Windows estão sincronizados.

Para exibir o Nome da Família de Pacotes dos aplicativos do Windows instalados, em um prompt de comando do Windows PowerShell, digite:

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

Para exibir uma lista dos aplicativos do Windows que podem sincronizar configurações em um computador com seu nome de família de pacotes, status habilitado e origem habilitada, em um prompt de comando do Windows PowerShell, digite: Get-UevAppxPackage

Definições de propriedades Get-UevAppxPackage

  • DisplayName
    O nome que é exibido para o usuário no aplicativo Centro de Configurações da Empresa. A propriedade DisplayName é derivada da propriedade PackageFamilyName.
  • PackageFamilyName
    O nome do pacote que está instalado para o usuário atual.
  • Habilitado
    Define se as configurações do aplicativo estão configuradas para sincronizar.
  • EnabledSource
    O local onde a configuração que habilita ou desabilita o aplicativo está definida. Os valores possíveis são: NotSet, LocalMachine, LocalUser, PolicyMachine e PolicyUser.
  • NotSet
    A política não está configurada para sincronizar este aplicativo.
  • LocalMachine
    O estado habilitado está definido na seção do computador local do Registro.
  • LocalUser
    O estado habilitado está definido na seção do usuário atual do Registro.
  • PolicyMachine
    O estado habilitado está definido na seção de política, da seção do computador local do Registro.

Para obter a lista configurada pelo usuário dos aplicativos do Windows, no prompt de comando do Windows PowerShell, digite: Get-UevAppxPackage –CurrentComputerUser

Para obter a lista configurada pelo computador dos aplicativos do Windows, no prompt de comando do Windows PowerShell, digite: Get-UevAppxPackage –Computer

Para qualquer um dos parâmetros, CurrentComputerUser ou Computer, o cmdlet exibe uma lista dos aplicativos do Windows que estão configurados no nível de usuário ou de computador.

Definições de propriedades

  • DisplayName
    O nome que é exibido para o usuário no aplicativo Centro de Configurações da Empresa. A propriedade DisplayName é derivada da propriedade PackageFamilyName.
  • PackageFamilyName
    O nome do pacote que está instalado para o usuário atual.
  • Habilitado
    Define se as configurações do aplicativo estão definidas para sincronizar para a alternância especificada, isto é, user ou computer.
  • Installed
    True se o aplicativo, isto é, o PackageFamilyName está instalado para o usuário atual.

Gerenciar modelos de local de configurações do UE-V 2 usando o WMI

O Virtualização da Experiência do Usuário fornece o conjunto de comandos do WMI a seguir. Os administradores podem usar essas interfaces para gerenciar modelos de local de configurações do Windows PowerShell e automatizar tarefas administrativas do modelo.

Para gerenciar modelos de local de configurações por meio da WMI

  1. Use uma conta com direitos de administrador para abrir uma janela do Windows PowerShell.

  2. Use os seguintes comandos do WMI para se registrar e gerenciar os modelos de local de configurações do UE-V.

    Windows PowerShell command Descrição

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

    Lista todos os modelos de local de configurações que são registrados para o computador.

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

    Obtém o nome, as informações de versão e o programa, que depende do nome do modelo.

    Get-WmiObject -Namespace root\Microsoft\UEV EffectiveWindows8App

    Obtém a lista efetiva de aplicativos do Windows.

    Get-WmiObject -Namespace root\Microsoft\UEV MachineConfiguredWindows8App

    Obtém a lista de aplicativos do Windows que estão configurados para o computador.

    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguredWindows8App

    Obtém a lista de aplicativos do Windows que estão configurados para o usuário atual.

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

    Registra um modelo de localização de configurações com o UE-V.

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

    Cancela o registro de um modelo de localização de configurações com o UE-V. Assim que um modelo é cancelado, o UE-V não sincronizará mais as configurações que são definidas no modelo entre computadores.

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

    Atualiza um modelo de localização de configurações com o UE-V. O novo modelo deve ser uma versão mais recente que o já existente.

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

    Remove um ou mais aplicativos do Windows da lista de aplicativos do Windows do computador.

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

    Remove um ou mais aplicativos do Windows da lista atual de aplicativos do Windows do usuário.

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

    Desabilita um ou mais modelos de local de configurações com o UE-V.

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

    Desabilita um ou mais aplicativos do Windows da lista de aplicativos do Windows do computador.

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

    Desabilita um ou mais aplicativos do Windows da lista atual de aplicativos do Windows do usuário.

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

    Habilita um modelo de localização de configurações com o UE-V.

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

    Habilita aplicativos do Windows na lista de aplicativos do Windows do computador.

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

    Habilita aplicativos do Windows na lista atual de aplicativos do Windows do usuário.

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

    Determina se um modelo de configurações de determinado local está em conformidade com o esquema XML.

    Dica

    Quando uma lista de nomes de família do pacote é chamada pelo comando WMI, a lista deve estar entre aspas e separados por um símbolo de pipe, por exemplo, "<package family name | package family name>".

Implantando o agente da UE-V usando o Windows PowerShell

Como implantar o agente do UE-V usando o Windows PowerShell

  1. Prepare o pacote de instalação do agente do UE-V em um compartilhamento de rede acessível.

    Dica

    Use o AgentSetup.exe para implantar as versões de 32 bits e de 64 bits do UE-V Agent. As versões de pacotes do Windows Installer, AgentSetupx86.msi e AgentSetupx64.msi estão disponíveis para cada arquitetura. Para desinstalar o agente do UE-V posteriormente usando o arquivo de instalação, você deve usar o mesmo tipo de arquivo.

  2. Use um dos seguintes comandos do Windows PowerShell para instalar o agente do UE-V.

    • & 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%

Você tem uma sugestão para UE-V? Adicione ou vote em sugestões aqui.
Você tem um problema com o UE-V? Utilize o Fórum do UE-V TechNet

Consulte também

Outros recursos

Administrando o UE-V 2.x com o Windows PowerShell e WMI
Administrando o UE-V 2. x