Compartilhar via

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

  • Artigo

Pode utilizar o Windows Management Instrumentation (WMI) e o Windows PowerShell para gerir o comportamento de sincronização e configuração do serviço de Virtualização de Experiência de Utilizador (UE-V).

Observação

Para obter uma lista completa dos cmdlets UE-V, veja User Experience Virtualization in Windows PowerShell (Virtualização da Experiência do Utilizador no Windows PowerShell).

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

  1. Abra uma janela 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 Windows PowerShell para configurar o serviço.

    comando do Windows PowerShell Descrição
    Enable-UEV Ativa o serviço UE-V. Requer reinício.
    Disable-UEV Desativa o serviço UE-V. Requer reinício.
    Get-UevStatus Mostra se o serviço UE-V está ativado ou desativado com um valor Booleano.
    Get-UevConfiguration Obtém as definições de serviço UE-V efetivas. 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 serviço UE-V apenas para o utilizador atual.
    Get-UevConfiguration -Computer Obtém os valores de definições de configuração do serviço 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 -EnableDontSyncWindows8AppSettings Configura o serviço UE-V para não sincronizar quaisquer aplicações do Windows para todos os utilizadores no computador.
    Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings Configura o serviço UE-V para não sincronizar quaisquer aplicações do Windows para o utilizador do computador atual.
    Set-UevConfiguration -Computer -EnableFirstUseNotification Configura o serviço UE-V para apresentar a notificação da primeira vez que o serviço é executado para todos os utilizadores no computador.
    Set-UevConfiguration -Computer -DisableFirstUseNotification Configura o serviço UE-V para não apresentar a notificação da primeira vez que o serviço é executado para todos os utilizadores no computador.
    Set-UevConfiguration -Computer -EnableSettingsImportNotify Configura o serviço 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 serviço 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 serviço 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. Para obter mais informações, veja "Get-UevAppxPackage" em Managing UE-V Settings Location Templates Using Windows PowerShell and WMI (Gerir Modelos de Localização de Definições UE-V com Windows PowerShell e WMI).

    Utilize o parâmetro DisableSyncUnlistedWindows8Apps para configurar o serviço UE-V para sincronizar apenas as aplicações do Windows explicitamente ativadas pela Lista de Windows App.
    Set-UevConfiguration -CurrentComputerUser - EnableSyncUnlistedWindows8Apps Configura o serviço 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. Para obter mais informações, veja "Get-UevAppxPackage" em Managing UE-V Settings Location Templates Using Windows PowerShell and WMI (Gerir Modelos de Localização de Definições UE-V com Windows PowerShell e WMI).

    Utilize o parâmetro DisableSyncUnlistedWindows8Apps para configurar o serviço UE-V para sincronizar apenas as aplicações do Windows explicitamente ativadas pela Lista de Windows App.
    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 serviço UE-V para comunicar quando o tamanho do ficheiro de 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 serviço 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> Defina 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 Export cmdlet exporta todas as definições do serviço 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 Windows PowerShell

  1. Abra uma janela de Windows PowerShell como administrador.

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

    comando do Windows PowerShell Descrição
    Export-UevPackage MicrosoftNotepad.pkgx Extrai as definições de um ficheiro de pacote do Microsoft Notepad 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 serviço 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 serviço 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 de Windows PowerShell.

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

    Windows PowerShell command Descrição
    Get-WmiObject -Namespace root\Microsoft\UEV Configuration Apresenta as definições ativas do serviço 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 serviço UE-V definida para um utilizador.
    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration Apresenta a configuração do serviço 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 serviço 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, limpe 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ções 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ções 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.

Quando terminar de configurar o serviço UE-V com wMI e 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 com o Windows PowerShell e o WMIa Administrar aVirtualização da Experiência de Utilizador UE-V no Windows PowerShell