Gerenciando o UE-V 1.0 Agent e Pacotes com o PowerShell e o WMI

  • Artigo

Aplica-se a: User Experience Virtualization 1.0

Você pode usar o WMI e o PowerShell para gerenciar a configuração e o comportamento de sincronização do Virtualização da Experiência do Usuário Microsoft (UE-V) Agent.

Como implantar o UE-V Agent com o PowerShell

  1. Prepare o arquivo do instalador 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 arquivos do Windows Installer, AgentSetupx86.msi e AgentSetupx64.msi, estão disponíveis para cada arquitetura. Para desinstalar o UE-V Agent em outro momento usando o arquivo de instalação, você deve usar o mesmo tipo de arquivo.

  2. Use um dos seguintes comandos do PowerShell para instalar o agent.

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

Como configurar o UE-V Agent com o PowerShell

  1. Use uma conta com direitos de administrador para abrir uma janela do PowerShell. Importe o módulo PowerShell do UE-V usando o comando a seguir.

    Import-module UEV

  2. Use os seguintes comandos do PowerShell para configurar o agent.

    Comando do PowerShell

    Descrição

    Get-UevConfiguration

    Exiba as configurações ativas do UE-V Agent. Configurações específicas do usuário têm precedência sobre as configurações do computador.

    Get-UevConfiguration - CurrentComputerUser

    Exiba os valores de configurações do UE-V Agent somente para o usuário atual.

    Get-UevConfiguration -Computer

    Exiba os valores de definições de configurações do UE-V Agent para todos os usuários no computador.

    Set-UevConfiguration -Computer -SettingsStoragePath <path to _settings_storage_location>

    Defina um local de armazenamento de configurações por computador.

    Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to _settings_storage_location>

    Defina um local de armazenamento de configurações por usuário.

    Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <tempo limite em milissegundos>

    Defina o tempo limite de sincronização em milissegundos

    Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <tempo limite em milissegundos>

    Defina o tempo limite de sincronização para o usuário atual.

    Set-UevConfiguration -Computer -MaxPackageSizeInBytes <tamanho em bytes>

    Configure o UE-V Agent para gerar relatórios quando o tamanho do arquivo de pacote de configurações atingir um limite definido. Defina o tamanho limite do pacote em bytes.

    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <tamanho em bytes>

    Defina o limite para o aviso de tamanho do pacote para o usuário atual.

    Set-UevConfiguration –Computer –SettingsTemplateCatalogPath <caminho do catálogo>

    Defina o caminho do catálogo de modelos de configurações.

    Set-UevConfiguration -Computer -SyncMethod <método de sincronização>

    Defina o método de sincronização: OfflineFiles ou None.

    Set-UevConfiguration -CurrentComputerUser -SyncMethod <método de sincronização>

    Defina o método de sincronização para o usuário atual. OfflineFiles ou None.

    Set-UEVConfiguration -Computer –EnableSettingsImportNotify

    Habilite a notificação para ocorrer quando a importação das configurações do usuário estiver atrasada.

    Use –DisableSettingsImportNotify para desabilitar a notificação.

    Set-UEVConfiguration - CurrentComputerUser -EnableSettingsImportNotify

    Habilite a notificação para o usuário atual quando a importação das configurações do usuário estiver atrasada.

    Use –DisableSettingsImportNotify para desabilitar a notificação.

    Set-UEVConfiguration -Computer -SettingsImportNotifyDelayInSeconds

    Especifique o tempo em segundos antes de o usuário ser notificado.

    Set-UEVConfiguration - CurrentComputerUser -SettingsImportNotifyDelayInSeconds

    Especifique o tempo em segundos antes das notificações para o usuário atual.

    Set-UevConfiguration –Computer –DisableSync

    Desabilite o UE-V para todos os usuários no computador.

    Use –EnableSync para habilitar ou habilitar novamente.

    Set-UevConfiguration –CurrentComputerUser -DisableSync

    Desabilite o UE-V para o usuário atual no computador.

    Use –EnableSync para habilitar ou habilitar novamente.

    Clear-UevConfiguration –Computer -<nome da configuração>

    Limpe uma configuração específica para todos os usuários no computador.

    Clear-UevConfiguration –CurrentComputerUser -<nome da configuração>

    Limpe uma configuração específica somente do usuário atual.

    Export-UevConfiguration <arquivo de migração de configurações>

    Exporte a configuração do computador do UE-V para um arquivo de migração de configurações. A extensão do arquivo deve ser ".uev".

    O cmdlet de exportação exporta todas as configurações do UE-V Agent configuráveis com o parâmetro -computer.

    Import-UevConfiguration <arquivo de migração de configurações>

    Importe as configurações do computador do UE-V de um arquivo de migração de configurações (arquivo .uev).

Como exportar as configurações de pacote do UE-V e reparar os modelos do UE-V com o PowerShell

  1. Abra uma janela do PowerShell como administrador. Importe o módulo PowerShell do UE-V com o comando a seguir.

    Import-module UEV

  2. Use os seguintes comandos do PowerShell para configurar o agent.

    Comando do PowerShell

    Descrição

    Export-UevPackage MicrosoftCalculator6.pkgx

    Extrai as configurações de um arquivo de pacote da Calculadora da Microsoft e as converte em um formato legível em XML.

    Repair-UevTemplateIndex

    Repara o índice dos modelos de local de configurações do UE-V.

Como configurar o UE-V Agent com o WMI

  1. O Virtualização da Experiência do Usuário fornece o conjunto de comandos do WMI a seguir. Os administradores podem usar essa interface para configurar o UE-V Agent na linha de comando e automatizar tarefas de configuração típicas.

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

  2. Use os seguintes comandos do WMI para configurar o agent.

    Comando do PowerShell Descrição

    Get-WmiObject -Namespace root\Microsoft\UEV Configuration

    Exiba as configurações ativas do UE-V Agent. Configurações específicas do usuário têm precedência sobre as configurações do computador.

    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    Exiba a configuração do UE-V Agent definida para o usuário.

    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    Exiba a configuração do UE-V Agent definida para o computador.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SettingsStoragePath = <path_to_settings_storage_location>

    $config.Put()

    Defina um local de armazenamento de configurações por computador.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    $config.SettingsStoragePath = <path_to_settings_storage_location>

    $config.Put()

    Defina um local de armazenamento de configurações por usuário.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds>

    $config.Put()

    Defina o tempo limite de sincronização em milissegundos.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.MaxPackageSizeInBytes = <size_in_bytes>

    $config.Put()

    Configure o UE-V Agent para gerar relatórios quando o tamanho do arquivo de pacote de configurações atingir um limite definido. Defina o tamanho limite do arquivo de pacote em bytes.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SyncMethod = <sync_method>

    $config.Put()

    Defina o método de sincronização: OfflineFiles ou None.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<nome da configuração> = <valor da configuração>

    $config.Put()

    Atualize uma configuração específica por computador. Para limpar a configuração, use $null como valor da configuração.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<nome da configuração> = <valor da configuração>

    $config.Put()

    Atualize uma configuração específica por usuário. Para limpar a configuração, use $null como valor da configuração.

    Após a configuração do UE-V Agent com o WMI e o PowerShell, a configuração definida é armazenada no registro nos seguintes locais:

    \HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\UEV\Agent\Configuration

    \HKEY_CURRENT_USER\SOFTWARE\Microsoft\UEV\Agent\Configuration

Consulte Também

Outros Recursos

Administrando o UE-V 1.0
Operações para o UE-V 1.0

-----
É possível obter mais informações sobre o MDOP na Biblioteca do TechNet, pesquisar sobre solução de problemas no Wiki da TechNet ou nos seguir no Facebook ou Twitter.
-----