Gerenciando modelos de localização de configurações ue-v 2.x usando Windows PowerShell e WMI

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

Gerenciar modelos de localização de configurações da UE-V 2 usando Windows PowerShell

Os recursos WMI e Windows PowerShell ue-V incluem a capacidade de habilitar, desabilitar, registrar, atualizar e cancelar o registro de modelos de localização de configurações. Usando esses recursos, você pode automatizar o processo de registro, atualização ou cancelamento de registro de modelos com o Agente UE-V. Você também pode registrar modelos manualmente usando comandos WMI e Windows PowerShell. Usando esses recursos em conjunto com uma solução de distribuição de software eletrônico, 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 local de configurações. As permissões de administrador não são necessárias para habilitar, desabilitar ou listar modelos.

Para gerenciar modelos de localização de configurações usando Windows PowerShell

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

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

   comando do Windows PowerShell	Descrição
   Get-UevTemplate	Lista todos os modelos de localização de configurações registrados no computador.
   Get-UevTemplate –Application <string>	Lista todos os modelos de localização de configurações registrados no computador em que o nome do aplicativo ou o nome do modelo contém cadeia de <caracteres>.
   Get-UevTemplate –TemplateID <string>	Lista todos os modelos de localização de configurações registrados no computador em que a ID do modelo contém cadeia de <caracteres>.
   Get-UevTemplate [-ApplicationOrTemplateID] <string>	Lista todos os modelos de localização de configurações registrados no computador em que o nome do aplicativo ou modelo ou a ID do modelo contém cadeia de <caracteres>.
   Get-UevTemplateProgram [-ID] <template ID>	Obtém o nome das informações do programa e da versão, 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 configurados para o computador.
   Get-UevAppXPackage -CurrentComputerUser	Obtém a lista de aplicativos do Windows configurados para o usuário atual.
   Register-UevTemplate [-Path] <template file path>[,<template file path>]	Registra um ou mais modelos de localização de configurações 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 definidas no modelo entre computadores que têm o modelo registrado.
   Register-UevTemplate –LiteralPath <template file path>[,<template file path>]	Registra um ou mais modelos de localização de configurações com o UE-V usando caminhos literais, em que nenhum caractere pode ser interpretado como caracteres curinga. Depois que um modelo é registrado, o UE-V sincroniza as configurações definidas no modelo entre computadores que têm o modelo registrado.
   Unregister-UevTemplate [-ID] <template ID>	Cancela o registro de um modelo de local de configurações com UE-V. Quando um modelo é cancelado, o UE-V não sincroniza mais as configurações definidas no modelo entre computadores.
   Unregister-UevTemplate -All	Cancela o registro de todos os modelos de localização de configurações com o UE-V. Quando um modelo é cancelado, o UE-V não sincroniza mais as configurações definidas no modelo entre computadores.
   Update-UevTemplate [-Path] <template file path>[,<template file path>]	Atualizações um ou mais modelos de localização de configurações com uma versão mais recente do modelo. Use caminhos relativos e/ou caracteres curinga nos caminhos do arquivo. O novo modelo deve ser uma versão mais recente do que o modelo existente.
   Update-UevTemplate –LiteralPath <template file path>[,<template file path>]	Atualizações um ou mais modelos de localização de configurações com uma versão mais recente do modelo. Use caminhos completos para arquivos de modelo, em que nenhum caractere pode ser interpretado como caracteres curinga. O novo modelo deve ser uma versão mais recente do 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 de aplicativos do Windows do usuário atual.
   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 de aplicativos do Windows do usuário atual.
   Clear-UevAppXPackage [–CurrentComputerUser] -All	Remove todos os aplicativos do Windows da lista de aplicativos do Windows do usuário atual.
   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 na lista de aplicativos do Windows do computador.
   Disable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]	Desabilita um ou mais aplicativos do Windows na lista de aplicativos do Windows do usuário atual.
   Enable-UevTemplate [-ID] <template ID>	Habilita um modelo de local 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 na lista de aplicativos do Windows do computador.
   Enable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]	Habilita um ou mais aplicativos do Windows na lista de aplicativos do Windows do usuário atual.
   Test-UevTemplate [-Path] <template file path>[,<template file path>]	Determina se um ou mais modelos de localização de configurações estão em conformidade 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 localização de configurações estão em conformidade com seu esquema XML. O caminho deve ser um caminho completo para o arquivo de modelo, mas não inclui caracteres curinga.

Os recursos de Windows PowerShell UE-V permitem que você gerencie um grupo de modelos de configurações implantados em sua empresa. Use o procedimento a seguir para gerenciar um grupo de modelos usando Windows PowerShell.

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

1. Modifique ou atualize os modelos de local de configurações desejados.

2. Se você quiser modificar ou atualizar os modelos de localização de configurações, implante esses modelos de localização de configurações em uma pasta acessível para o computador local.

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

4. Cancele o registro de todas as versões registradas anteriormente 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 localização de configurações localizados na pasta de modelo especificada.

Lista de aplicativos do Windows

Ao listar um aplicativo do Windows na lista de aplicativos do Windows, você especifica se esse aplicativo está habilitado ou desabilitado para sincronização de configurações. Os aplicativos são identificados na lista pelo nome da Família de Pacotes e se a sincronização de configurações deve ser habilitada ou desabilitada para esse aplicativo. Ao usar essas configurações junto com a configuração comportamento de sincronização padrão não listada, 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 Windows PowerShell comando, insira:

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

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

Definições de Get-UevAppxPackage propriedades

Displayname
O nome que é exibido para o usuário no aplicativo Centro de Configurações da Empresa. A DisplayName propriedade é derivada da PackageFamilyName propriedade.

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 sincronização.

EnabledSource
O local em que 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 é definido na seção de computador local do Registro.

LocalUser
O estado habilitado é definido na seção de usuário atual do Registro.

PolicyMachine
O estado habilitado é definido na seção de política da seção de computador local do Registro.

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

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

Para qualquer parâmetro, CurrentComputerUser ou Computer, o cmdlet retorna uma lista dos aplicativos do Windows configurados no usuário ou no nível do computador.

Definições de propriedades

Displayname
O nome que é exibido para o usuário no aplicativo Centro de Configurações da Empresa. A DisplayName propriedade é derivada da PackageFamilyName propriedade.

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 o comutador especificado, ou seja, usuário ou computador.

Instalado
True se o aplicativo, ou seja, PackageFamilyName estiver instalado para o usuário atual.

Gerenciar modelos de localização de configurações da UE-V 2 usando o WMI

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

Para gerenciar modelos de localização de configurações usando o WMI

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

2. Use os comandos WMI a seguir para 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 localização de configurações registrados para o computador.
   Invoke-WmiMethod –Namespace root\Microsoft\UEV –Class SettingsLocationTemplate –Name GetProcessInfoByTemplateId <template Id>	Obtém o nome das informações do programa e da versão, 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 configurados para o computador.
   Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguredWindows8App	Obtém a lista de aplicativos do Windows configurados para o usuário atual.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Register -ArgumentList <template path >	Registra um modelo de local 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 local de configurações com UE-V. Assim que um modelo é cancelado, o UE-V não sincroniza mais as configurações definidas no modelo entre computadores.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList <template path>	Atualizações um modelo de localização de configurações com UE-V. O novo modelo deve ser uma versão mais recente do que a 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 de aplicativos do Windows do usuário atual.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name DisableByTemplateId -ArgumentList <template ID>	Desabilita um ou mais modelos de localização 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 na 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 na lista de aplicativos do Windows do usuário atual.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name EnableByTemplateId -ArgumentList <template ID>	Habilita um modelo de local de configurações com 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 de aplicativos do Windows do usuário atual.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList <template path>	Determina se um determinado modelo de local de configurações está em conformidade com seu esquema XML.

Observação
Quando uma lista de Nomes de Família de Pacotes é chamada pelo comando WMI, a lista deve estar entre aspas e separada por um símbolo de pipe, por exemplo, "<package family name | package family name>".

Implantando o agente UE-V usando Windows PowerShell

Como implantar o agente UE-V usando o Windows PowerShell

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

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

2. Use um dos comandos de Windows PowerShell a seguir para instalar o Agente 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%

Tem um problema de UE-V? Use o Fórum do TechNet da UE-V.

Tópicos relacionados

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

Administrando o UE-V 2.x