Compartilhar via

Gerir o agente UE-V 2.1 SP1 e pacotes com o Windows PowerShell e o WMI

  • Artigo

Pode utilizar o Windows Management Instrumentation (WMI) e o Windows PowerShell para gerir o comportamento de sincronização e configuração do Agente do Microsoft User Experience Virtualization (UE-V) 2.1 SP1. Para obter uma lista completa dos cmdlets do PowerShell UE-V, veja Referência de cmdlets MDOP.

Para implementar o Agente UE-V com o Windows PowerShell

  1. Teste o ficheiro do instalador UE-V numa partilha de rede acessível.

    Observação

    Utilize AgentSetup.exe para implementar versões de 32 bits e de 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 utilizando o ficheiro de instalação, tem de utilizar o mesmo tipo de ficheiro.

  2. Para instalar o Agente UE-V, utilize um dos seguintes comandos do 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%

Para configurar o Agente UE-V com o Windows PowerShell

  1. Abra uma janela do Windows PowerShell. Para gerir as definições do computador que afetam todos os utilizadores do computador com o parâmetro Computador , abra a janela com uma conta que tenha direitos de administrador.

  2. Utilize os seguintes comandos do Windows PowerShell para configurar o agente.

comando do Windows PowerShell Descrição
Get-UevConfiguration Obtém as definições efetivas do Agente UE-V. As definições específicas do utilizador têm precedência sobre as definições do computador.
Get-UevConfiguration -CurrentComputerUser Obtém os valores de definições do Agente UE-V apenas para o utilizador atual.
Get-UevConfiguration -Computer Obtém os valores de definições de configuração do Agente UE-V para todos os utilizadores no computador.
Get-UevConfiguration -Details Obtém os detalhes de cada definição de configuração. Mostra onde a definição está configurada ou se utiliza o valor predefinido. É apresentado se a definição atual for válida.
Set-UevConfiguration -Computer -ContactITDescription <IT description> Define o texto apresentado no Centro de Definições da Empresa para a ligação de ajuda.
Set-UevConfiguration -Computer -ContactITUrl <string> Define o URL da ligação no Centro de Definições da Empresa para a ligação de ajuda. Qualquer protocolo de URL pode ser utilizado.
Set-UevConfiguration -Computer -EnableDontSyncWindows8AppSettings Configura o Agente UE-V para não sincronizar quaisquer aplicações do Windows para todos os utilizadores no computador.
Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings Configura o Agente UE-V para não sincronizar quaisquer aplicações do Windows para o utilizador do computador atual.
Set-UevConfiguration -Computer -EnableFirstUseNotification Configura o Agente UE-V para apresentar a notificação da primeira vez que o agente é executado para todos os utilizadores no computador.
Set-UevConfiguration -Computer -DisableFirstUseNotification Configura o Agente UE-V para não apresentar a notificação da primeira vez que o agente é executado para todos os utilizadores no computador.
Set-UevConfiguration -Computer -EnableSettingsImportNotify Configura o Agente UE-V para notificar todos os utilizadores no computador quando a sincronização de definições está atrasada. Utilize o parâmetro DisableSettingsImportNotify para desativar a notificação.
Set-UevConfiguration -CurrentComputerUser -EnableSettingsImportNotify Configura o Agente UE-V para notificar o utilizador atual quando a sincronização de definições está atrasada. Utilize o parâmetro DisableSettingsImportNotify para desativar a notificação.
Set-UevConfiguration -Computer -EnableSyncUnlistedWindows8Apps Configura o Agente UE-V para sincronizar todas as aplicações do Windows que não estão explicitamente desativadas pela lista de aplicações do Windows para todos os utilizadores do computador. Utilize o DisableSyncUnlistedWindows8Apps parâmetro para configurar o Agente UE-V para sincronizar apenas as aplicações do Windows explicitamente ativadas pela Lista de Aplicações do Windows.
Set-UevConfiguration -CurrentComputerUser -EnableSyncUnlistedWindows8Apps Configura o Agente UE-V para sincronizar todas as aplicações do Windows que não estão explicitamente desativadas pela lista de aplicações do Windows para o utilizador atual no computador. Utilize o DisableSyncUnlistedWindows8Apps parâmetro para configurar o Agente UE-V para sincronizar apenas as aplicações do Windows explicitamente ativadas pela Lista de Aplicações do Windows.
Set-UevConfiguration -Computer -DisableSync Desativa UE-V para todos os utilizadores no computador. Utilize o parâmetro EnableSync para ativar ou reativar.
Set-UevConfiguration -CurrentComputerUser -DisableSync Desativa UE-V para o utilizador atual no computador. Utilize o parâmetro EnableSync para ativar ou reativar.
Set-UevConfiguration -Computer -EnableTrayIcon Ativa o ícone UE-V na área de notificação para todos os utilizadores do computador. Utilize o parâmetro DisableTrayIcon para desativar o ícone.
Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes> Configura o agente UE-V para comunicar quando o tamanho do ficheiro do pacote de definições atinge o limiar definido para todos os utilizadores no computador. Define o tamanho do pacote de limiar em bytes.
Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes> Configura o agente UE-V para comunicar quando o tamanho do ficheiro de pacote de definições atinge o limiar definido. Define o limiar de aviso de tamanho do pacote para o utilizador atual.
Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds Especifica o tempo em segundos antes de o utilizador ser notificado para todos os utilizadores do computador.
Set-UevConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds Especifica o tempo em segundos antes do envio da notificação para o utilizador atual.
Set-UevConfiguration -Computer -SettingsStoragePath <path to settings storage location> Define uma localização de armazenamento de definições por computador para todos os utilizadores do computador.
Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to settings storage location> Define uma localização de armazenamento de definições por utilizador.
Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <path to catalog> Define o caminho do catálogo de modelos de definições para todos os utilizadores do computador.
Set-UevConfiguration -Computer -SyncMethod <sync method> Define o método de sincronização para todos os utilizadores do computador: SyncProvider ou None.
Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method> Define o método de sincronização para o utilizador atual: SyncProvider ou None.
Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds> Define o tempo limite da sincronização em milissegundos para todos os utilizadores do computador.
Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds> Define o tempo limite da sincronização para o utilizador atual.
Clear-UevConfiguration -Computer -<setting name> Limpa a definição especificada para todos os utilizadores no computador.
Clear-UevConfiguration -CurrentComputerUser -<setting name> Limpa a definição especificada apenas para o utilizador atual.
Export-UevConfiguration <settings migration file> Exporta a configuração do computador UE-V para um ficheiro de migração de definições. A extensão de nome de ficheiro tem de ser .uev. O cmdlet Exportar exporta todas as definições do Agente UE-V configuráveis com o parâmetro Computador .
Import-UevConfiguration <settings migration file> Importa a configuração do computador UE-V a partir de um ficheiro de migração de definições. A extensão de nome de ficheiro tem de ser .uev.

Para exportar as definições do pacote UE-V e reparar modelos UE-V com o Windows PowerShell

  1. Abra uma janela do Windows PowerShell como administrador.

  2. Utilize os seguintes comandos do Windows PowerShell para configurar o agente.

    comando do Windows PowerShell Descrição
    Export-UevPackage MicrosoftCalculator6.pkgx Extrai as definições de um ficheiro de pacote da Microsoft Calculator e converte-as num formato legível por humanos em XML.
    Repair-UevTemplateIndex Repara o índice dos modelos de localização das definições ue-V.

Para configurar o Agente UE-V com o WMI

  1. A Virtualização da Experiência do Utilizador fornece o seguinte conjunto de comandos WMI. Os administradores podem utilizar esta interface para configurar o agente UE-V na linha de comandos e automatizar tarefas de configuração típicas.

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

  2. Utilize os seguintes comandos WMI para configurar o agente.

    comando do Windows PowerShell Descrição
    Get-WmiObject -Namespace root\Microsoft\UEV Configuration Apresenta as definições ativas do Agente UE-V. As definições específicas do utilizador têm precedência sobre as definições do computador.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration Apresenta a configuração do Agente UE-V definida para um utilizador.
    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration Apresenta a configuração do Agente UE-V definida para um computador.
    Get-WmiObject -Namespace root\Microsoft\Uev ConfigurationItem Apresenta os detalhes de cada item de configuração.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SettingsStoragePath = <path_to_settings_storage_location>
    $config.Put()    		 Define uma localização de armazenamento por computador.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration
    $config.SettingsStoragePath = <path_to_settings_storage_location>
    $config.Put()    		 Define uma localização de armazenamento de definições por utilizador.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds>
    $config.Put()    		 Define o tempo limite da sincronização em milissegundos para todos os utilizadores do computador.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.MaxPackageSizeInBytes = <size_in_bytes>
    $config.Put()    		 Configura o Agente UE-V para comunicar quando o tamanho do ficheiro do pacote de definições atinge um limiar definido. Defina o tamanho do ficheiro do pacote de limiar em bytes para todos os utilizadores do computador.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SyncMethod = <sync_method>
    $config.Put()    		 Define o método de sincronização para todos os utilizadores do computador: SyncProvider ou None.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $true
    $config.Put()    		 Para ativar uma definição específica por computador, desmarque a definição e utilize $null como o valor de definição. Utilize UserConfiguration para definições por utilizador.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $false
    $config.Put()    		 Para desativar uma definição específica por computador, desmarque a definição e utilize $null como o valor de definição. Utilize a Configuração do Utilizador para definições por utilizador.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 Atualiza uma definição específica por computador. Para limpar a definição, utilize $null como o valor de definição.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 Atualiza uma definição específica por utilizador para todos os utilizadores do computador. Para limpar a definição, utilize $null como o valor de definição.

Após a configuração do Agente UE-V com o WMI e o Windows PowerShell, a configuração definida é armazenada no registo nas seguintes localizações.

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

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

Para exportar as definições do pacote UE-V e reparar modelos UE-V com o WMI

  1. O UE-V fornece o seguinte conjunto de comandos WMI. Os administradores podem utilizar esta interface para exportar um pacote ou reparar modelos UE-V.

  2. Utilize os seguintes comandos WMI.

    Comando WMI Descrição
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserSettings -Name ExportPackage -ArgumentList <package name> Extrai as definições de um ficheiro de pacote e converte-as num formato legível por humanos em XML.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name RebuildIndex Repara o índice dos modelos de localização das definições ue-V. Tem de ser executado como administrador.

Administrar o UE-V 2.1 SP1 com o Windows PowerShell e o WMI

Administrar UE-V 2.1 SP1