Compartilhar via

Gerenciando modelos de local de configurações UE-V usando Windows PowerShell e WMI (Windows 10)

  • Artigo

A UE-V (User Experience Virtualization) usa modelos de local de configurações XML para definir as configurações que a Virtualização de Experiência do Usuário captura e aplica. UE-V inclui um conjunto de modelos de local de configurações padrão. Ele também inclui a ferramenta geradora de modelo UE-V que permite criar modelos de local de configurações personalizadas. Depois de criar e implantar modelos de localização de configurações, você pode gerenciar esses modelos usando Windows PowerShell e a WMI (Instrumentação de Gerenciamento do Windows).

Observação

Para obter uma lista completa de cmdlets UE-V, consulte Virtualização de Experiência do Usuário em Windows PowerShell.

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

Os recursos WMI e Windows PowerShell da UE-V incluem a capacidade de habilitar, desabilitar, registrar, atualizar e cancelar o registro de modelos de local. Usando esses recursos, você pode automatizar o processo de registro, atualização ou cancelamento de registro de modelos com o serviço UE-V. Você também pode registrar manualmente modelos 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 de comando Windows PowerShell.

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

    comando do Windows PowerShell Descrição
    Get-UevTemplate Listas todos os modelos de localização de configurações registrados no computador.
    Get-UevTemplate -Application <string> Listas 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.
    Get-UevTemplate -TemplateID <string> Listas todos os modelos de localização de configurações registrados no computador onde a ID do modelo contém.
    Get-UevTemplate [-ApplicationOrTemplateID] <string> Listas todos os modelos de localização de configurações registrados no computador em que o aplicativo ou o nome do modelo ou ID do modelo contém.
    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 windows.
    Get-UevAppXPackage -Computer Obtém a lista de aplicativos windows configurados para o computador.
    Get-UevAppXPackage -CurrentComputerUser Obtém a lista de aplicativos 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 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 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 não é registrado, 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 UE-V. Quando um modelo não é registrado, 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 Windows da lista de aplicativos windows do computador.
    Clear-UevAppXPackage -CurrentComputerUser Remove o aplicativo Windows da lista de aplicativos windows do usuário atual.
    Clear-UevAppXPackage -Computer -All Remove todos os aplicativos windows da lista de aplicativos windows do computador.
    Clear-UevAppXPackage [-CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>] Remove um ou mais aplicativos Windows da lista de aplicativos windows do usuário atual.
    Clear-UevAppXPackage [-CurrentComputerUser] -All Remove todos os aplicativos windows da lista de aplicativos windows do usuário atual.
    Disable-UevTemplate [-ID] <template ID> Desabilita um modelo de local 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 Windows na lista de aplicativos windows do computador.
    Disable-UevAppXPackage [-CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>] Desabilita um ou mais aplicativos Windows na lista de aplicativos windows do usuário atual.
    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 Windows na lista de aplicativos windows do computador.
    Enable-UevAppXPackage [-CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>] Habilita um ou mais aplicativos Windows na lista de aplicativos 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 gerenciar 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 local de configurações, implante esses modelos de localização de configurações em uma pasta acessível ao computador local.

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

  4. Cancelar 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 local de configurações localizados na pasta de modelo especificada.

Lista de aplicativos do Windows

Ao listar um aplicativo 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. Quando você usa essas configurações junto com a configuração comportamento de sincronização padrão não listada, você pode controlar se os aplicativos Windows estão sincronizados.

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

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

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

Definições de propriedades Get-UevAppxPackage

PackageFamilyName

O nome do pacote instalado para o usuário atual.

Habilitado

Define se as configurações do aplicativo estão configuradas para sincronizar.

EnableedSource

O local em que a configuração que habilita ou desabilita o aplicativo é 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 política da seção de computador local do registro.

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

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

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

Definições de propriedades

PackageFamilyName

O nome do pacote instalado para o usuário atual.

Habilitado

Define se as configurações do aplicativo estão configuradas para sincronizar para a opção especificada, ou seja, usuário ou computador.

Instalado

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

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

A Virtualização de 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 de Windows PowerShell e 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 janela de Windows PowerShell.

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

    Windows PowerShell command Descrição
    Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate Select-Object TemplateId,TemplateName, TemplateVersion,Enabled Format-Table -Autosize Listas 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 windows.
    Get-WmiObject -Namespace root\Microsoft\UEV MachineConfiguredWindows8App Obtém a lista de aplicativos windows configurados para o computador.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguredWindows8App Obtém a lista de aplicativos 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 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 não for registrado, 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 local 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> Remove um ou mais aplicativos Windows da lista de aplicativos windows do computador.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name> Remove um ou mais aplicativos Windows da lista de aplicativos 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 UE-V.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name DisableApp -ArgumentList <package family name> Desabilita um ou mais aplicativos Windows na lista de aplicativos windows do computador.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name DisableApp -ArgumentList <package family name> Desabilita um ou mais aplicativos Windows na lista de aplicativos 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> Habilita aplicativos windows na lista de aplicativos windows do computador.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <package family name> Habilita aplicativos windows na lista de aplicativos 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>".

Administrando UE-V com Windows PowerShell e wmiadministrando virtualização de experiência do usuário UE-Vem Windows PowerShell