Compartilhar via

Gerenciando o serviço UE-V e pacotes com Windows PowerShell e WMI (Windows 10)

  • Artigo

Você pode usar a WMI (Instrumentação de Gerenciamento do Windows) e Windows PowerShell para gerenciar o comportamento de configuração e sincronização do serviço UE-V (Experiência do Usuário).

Observação

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

Para configurar o serviço UE-V com Windows PowerShell

  1. Abra uma janela Windows PowerShell. Para gerenciar configurações de computador que afetam todos os usuários do computador usando o parâmetro Computador , abra a janela com uma conta com direitos de administrador.

  2. Use os seguintes comandos Windows PowerShell para configurar o serviço.

    comando do Windows PowerShell Descrição
    Enable-UEV Ativa o serviço UE-V. Requer reinicialização.
    Disable-UEV Desativa o serviço UE-V. Requer reinicialização.
    Get-UevStatus Exibe se o serviço UE-V está habilitado ou desabilitado, usando um valor booliano.
    Get-UevConfiguration Obtém as configurações de serviço UE-V eficazes. As configurações específicas do usuário têm precedência sobre as configurações do computador.
    Get-UevConfiguration -CurrentComputerUser Obtém os valores de configurações de serviço UE-V somente para o usuário atual.
    Get-UevConfiguration -Computer Obtém os valores de configuração de serviço UE-V para todos os usuários no computador.
    Get-UevConfiguration -Details Obtém os detalhes de cada configuração. Exibe onde a configuração está configurada ou se ela usa o valor padrão. Será exibido se a configuração atual for válida.
    Set-UevConfiguration -Computer -EnableDontSyncWindows8AppSettings Configura o serviço UE-V para não sincronizar nenhum aplicativo Windows para todos os usuários no computador.
    Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings Configura o serviço UE-V para não sincronizar nenhum aplicativo Windows para o usuário de computador atual.
    Set-UevConfiguration -Computer -EnableFirstUseNotification Configura o serviço UE-V para exibir a notificação na primeira vez que o serviço é executado para todos os usuários no computador.
    Set-UevConfiguration -Computer -DisableFirstUseNotification Configura o serviço UE-V para não exibir a notificação na primeira vez que o serviço é executado para todos os usuários no computador.
    Set-UevConfiguration -Computer -EnableSettingsImportNotify Configura o serviço UE-V para notificar todos os usuários no computador quando a sincronização de configurações está atrasada.

    Use o parâmetro DisableSettingsImportNotify para desabilitar a notificação.
    Set-UevConfiguration -CurrentComputerUser -EnableSettingsImportNotify Configura o serviço UE-V para notificar o usuário atual quando a sincronização de configurações está atrasada.

    Use o parâmetro DisableSettingsImportNotify para desabilitar a notificação.
    Set-UevConfiguration -Computer -EnableSyncUnlistedWindows8Apps Configura o serviço UE-V para sincronizar todos os aplicativos Windows que não estão explicitamente desabilitados pela lista de aplicativos do Windows para todos os usuários do computador. Para obter mais informações, consulte "Get-UevAppxPackage" no gerenciamento de modelos de localização de configurações UE-V usando Windows PowerShell e WMI.

    Use o parâmetro DisableSyncUnlistedWindows8Apps para configurar o serviço UE-V para sincronizar apenas aplicativos Windows habilitados explicitamente pela Lista de Aplicativos do Windows.
    Set-UevConfiguration -CurrentComputerUser - EnableSyncUnlistedWindows8Apps Configura o serviço UE-V para sincronizar todos os aplicativos Windows que não estão explicitamente desabilitados pela lista de aplicativos do Windows para o usuário atual no computador. Para obter mais informações, consulte "Get-UevAppxPackage" no gerenciamento de modelos de localização de configurações UE-V usando Windows PowerShell e WMI.

    Use o parâmetro DisableSyncUnlistedWindows8Apps para configurar o serviço UE-V para sincronizar apenas aplicativos Windows habilitados explicitamente pela Lista de Aplicativos do Windows.
    Set-UevConfiguration -Computer -DisableSync Desabilita UE-V para todos os usuários no computador.

    Use o parâmetro EnableSync para habilitar ou habilitar novamente.
    Set-UevConfiguration -CurrentComputerUser -DisableSync Desabilita UE-V para o usuário atual no computador.

    Use o parâmetro EnableSync para habilitar ou habilitar novamente.
    Set-UevConfiguration -Computer -EnableTrayIcon Habilita o ícone UE-V na área de notificação para todos os usuários do computador.

    Use o parâmetro DisableTrayIcon para desabilitar o ícone.
    Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes> Configura o serviço UE-V para relatar quando um tamanho de arquivo de pacote de configurações atinge o limite definido para todos os usuários no computador. Define o tamanho do pacote de limite em bytes.
    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes> Configura o serviço UE-V para relatar quando um tamanho de arquivo de pacote de configurações atinge o limite definido. Define o limite de aviso de tamanho do pacote para o usuário atual.
    Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds Especifica o tempo em segundos antes que o usuário seja notificado para todos os usuários do computador
    Set-UevConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds Especifica o tempo em segundos antes da notificação para o usuário atual ser enviada.
    Set-UevConfiguration -Computer -SettingsStoragePath <path to _settings_storage_location> Define um local de armazenamento de configurações por computador para todos os usuários do computador.
    Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to _settings_storage_location> Define um local de armazenamento de configurações por usuário.
    Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <path to catalog> Define o caminho do catálogo de modelos de configurações para todos os usuários do computador.
    Set-UevConfiguration -Computer -SyncMethod <sync method> Define o método de sincronização para todos os usuários do computador: SyncProvider ou None.
    Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method> Define o método de sincronização para o usuário atual: SyncProvider ou None.
    Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds> Define o tempo limite de sincronização em milissegundos para todos os usuários do computador
    Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds> Defina o tempo limite de sincronização para o usuário atual.
    Clear-UevConfiguration -Computer -<setting name> Limpa a configuração especificada para todos os usuários no computador.
    Clear-UevConfiguration -CurrentComputerUser -<setting name> Limpa a configuração especificada somente para o usuário atual.
    Export-UevConfiguration <settings migration file> Exporta a configuração do computador UE-V para um arquivo de migração de configurações. A extensão do nome do arquivo deve ser .uev.

    O Export cmdlet exporta todas as configurações de serviço UE-V configuráveis com o parâmetro Computador.
    Import-UevConfiguration <settings migration file> Importa a configuração do computador UE-V de um arquivo de migração de configurações. A extensão do nome do arquivo deve ser .uev.

Para exportar configurações de pacote UE-V e reparar modelos UE-V com Windows PowerShell

  1. Abra uma janela Windows PowerShell como administrador.

  2. Use os seguintes comandos Windows PowerShell para configurar o serviço.

    comando do Windows PowerShell Descrição
    Export-UevPackage MicrosoftNotepad.pkgx Extrai as configurações de um arquivo de pacote do Microsoft Notepad e as converte em um formato legível por humanos no XML.
    Repair-UevTemplateIndex Repara o índice dos modelos de local de configurações UE-V.

Para configurar o serviço UE-V com o WMI

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

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

  2. Use os seguintes comandos WMI para configurar o serviço.

    Windows PowerShell command Descrição
    Get-WmiObject -Namespace root\Microsoft\UEV Configuration Exibe as configurações ativas do serviço UE-V. As configurações específicas do usuário têm precedência sobre as configurações do computador.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration Exibe a configuração de serviço UE-V definida para um usuário.
    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration Exibe a configuração de serviço UE-V definida para um computador.
    Get-WmiObject -Namespace root\Microsoft\Uev ConfigurationItem Exibe 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 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()

    		 Define 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()

    		 Define o tempo limite de sincronização em milissegundos para todos os usuários do computador.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.MaxPackageSizeInBytes = <size_in_bytes>

    $config.Put()

    		 Configura o serviço UE-V para relatar quando um tamanho de arquivo de pacote de configurações atinge um limite definido. Defina o tamanho do arquivo de pacote de limite em bytes para todos os usuários 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 usuários do computador: SyncProvider ou None.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<setting name> = $true

    $config.Put()

    		 Para habilitar uma configuração específica por computador, desmarque a configuração e use $null como o valor de configuração. Use UserConfiguration para configurações por usuário.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<setting name> = $false

    $config.Put()

    		 Para desabilitar uma configuração específica por computador, desmarque a configuração e use $null como o valor de configuração. Use a Configuração do Usuário para configurações por usuário.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<setting name> = <setting value>

    $config.Put()

    		 Atualizações uma configuração específica por computador. Para limpar a configuração, use $null como o valor de configuração.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<setting name> = <setting value>

    $config.Put()

    		 Atualizações uma configuração específica por usuário para todos os usuários do computador. Para limpar a configuração, use $null como o valor de configuração.

Quando você terminar de configurar o serviço UE-V com WMI e Windows PowerShell, a configuração definida será armazenada no registro nos locais a seguir.

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

Para exportar configurações de pacote UE-V e reparar modelos UE-V usando WMI

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

  2. Use os seguintes comandos WMI.

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

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