Поделиться через

Управление агентом и пакетами UE-V 2.1 с пакетом обновления 1 (SP1) с помощью Windows PowerShell и WMI

  • Статья

С помощью инструментария управления Windows (WMI) и Windows PowerShell можно управлять конфигурацией и синхронизацией агента microsoft User Experience Virtualization (UE-V) 2.1 с пакетом обновления 1 (SP1). Полный список командлетов PowerShell UE-V см. в справочнике по командлетам MDOP.

Развертывание агента UE-V с помощью Windows PowerShell

  1. Разведите файл установщика UE-V в доступной сетевой папке.

    Примечание.

    Используйте AgentSetup.exe для развертывания 32- и 64-разрядных версий агента UE-V. Пакеты установщика Windows, AgentSetupx86.msi и AgentSetupx64.msi, доступны для каждой архитектуры. Чтобы позже удалить агент UE-V с помощью файла установки, необходимо использовать тот же тип файла.

  2. Чтобы установить агент UE-V, используйте одну из следующих команд 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%

Настройка агента UE-V с помощью Windows PowerShell

  1. Откройте окно Windows PowerShell. Чтобы управлять параметрами компьютера, влияющими на всех пользователей компьютера, с помощью параметра Computer откройте окно с учетной записью с правами администратора.

  2. Используйте следующие команды Windows PowerShell для настройки агента.

Команда Windows PowerShell Описание
Get-UevConfiguration Возвращает действующие параметры агента UE-V. Пользовательские параметры имеют приоритет над параметрами компьютера.
Get-UevConfiguration -CurrentComputerUser Возвращает значения параметров агента UE-V только для текущего пользователя.
Get-UevConfiguration -Computer Возвращает значения параметров конфигурации агента UE-V для всех пользователей на компьютере.
Get-UevConfiguration -Details Возвращает сведения для каждого параметра конфигурации. Отображает, где настроен параметр или используется ли он значение по умолчанию. Отображается, если текущий параметр действителен.
Set-UevConfiguration -Computer -ContactITDescription <IT description> Задает текст, отображаемый в Центре параметров компании для ссылки на справку.
Set-UevConfiguration -Computer -ContactITUrl <string> Задает URL-адрес ссылки в Центре параметров компании для ссылки справки. Можно использовать любой протокол URL-адреса.
Set-UevConfiguration -Computer -EnableDontSyncWindows8AppSettings Настраивает агент UE-V так, чтобы не синхронизировать приложения Windows для всех пользователей на компьютере.
Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings Настраивает агент UE-V так, чтобы не синхронизировать приложения Windows для текущего пользователя компьютера.
Set-UevConfiguration -Computer -EnableFirstUseNotification Настраивает агент UE-V для отображения уведомлений при первом запуске агента для всех пользователей на компьютере.
Set-UevConfiguration -Computer -DisableFirstUseNotification Настраивает агент UE-V так, чтобы не отображалось уведомление при первом запуске агента для всех пользователей на компьютере.
Set-UevConfiguration -Computer -EnableSettingsImportNotify Настраивает агент UE-V для уведомления всех пользователей на компьютере о задержке синхронизации параметров. Используйте параметр DisableSettingsImportNotify , чтобы отключить уведомление.
Set-UevConfiguration -CurrentComputerUser -EnableSettingsImportNotify Настраивает агент UE-V для уведомления текущего пользователя о задержке синхронизации параметров. Используйте параметр DisableSettingsImportNotify , чтобы отключить уведомление.
Set-UevConfiguration -Computer -EnableSyncUnlistedWindows8Apps Настраивает агент UE-V для синхронизации всех приложений Windows, которые не отключены явным образом в списке приложений Windows для всех пользователей компьютера. DisableSyncUnlistedWindows8Apps Используйте параметр , чтобы настроить агент UE-V для синхронизации только приложений Windows, которые явно включены в списке приложений Windows.
Set-UevConfiguration -CurrentComputerUser -EnableSyncUnlistedWindows8Apps Настраивает агент UE-V для синхронизации всех приложений Windows, которые явно не отключены в списке приложений Windows для текущего пользователя на компьютере. DisableSyncUnlistedWindows8Apps Используйте параметр , чтобы настроить агент UE-V для синхронизации только приложений Windows, которые явно включены в списке приложений Windows.
Set-UevConfiguration -Computer -DisableSync Отключает UE-V для всех пользователей на компьютере. Используйте параметр EnableSync для включения или повторного включения.
Set-UevConfiguration -CurrentComputerUser -DisableSync Отключает UE-V для текущего пользователя на компьютере. Используйте параметр EnableSync для включения или повторного включения.
Set-UevConfiguration -Computer -EnableTrayIcon Включает значок UE-V в области уведомлений для всех пользователей компьютера. Используйте параметр DisableTrayIcon , чтобы отключить значок.
Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes> Настраивает агент UE-V так, чтобы он сообщал, когда размер файла пакета параметров достигает заданного порогового значения для всех пользователей на компьютере. Задает пороговый размер пакета в байтах.
Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes> Настраивает агент UE-V так, чтобы он сообщал, когда размер файла пакета параметров достигает заданного порогового значения. Задает пороговое значение предупреждения о размере пакета для текущего пользователя.
Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds Указывает время в секундах до уведомления пользователя для всех пользователей компьютера.
Set-UevConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds Указывает время в секундах до отправки уведомления для текущего пользователя.
Set-UevConfiguration -Computer -SettingsStoragePath <path to settings storage location> Определяет расположение хранилища параметров для каждого компьютера для всех пользователей компьютера.
Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to settings storage location> Определяет расположение хранилища параметров для каждого пользователя.
Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <path to catalog> Задает путь к каталогу шаблонов параметров для всех пользователей компьютера.
Set-UevConfiguration -Computer -SyncMethod <sync method> Задает метод синхронизации для всех пользователей компьютера: SyncProvider или None.
Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method> Задает метод синхронизации для текущего пользователя: SyncProvider или None.
Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds> Задает время ожидания синхронизации в миллисекундах для всех пользователей компьютера.
Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds> Задает время ожидания синхронизации для текущего пользователя.
Clear-UevConfiguration -Computer -<setting name> Очищает указанный параметр для всех пользователей на компьютере.
Clear-UevConfiguration -CurrentComputerUser -<setting name> Очищает указанный параметр только для текущего пользователя.
Export-UevConfiguration <settings migration file> Экспортирует конфигурацию компьютера UE-V в файл миграции параметров. Расширение имени файла должно иметь значение .uev. Командлет Export экспортирует все параметры агента UE-V, которые можно настроить с помощью параметра Computer .
Import-UevConfiguration <settings migration file> Импортирует конфигурацию компьютера UE-V из файла миграции параметров. Расширение имени файла должно иметь значение .uev.

Экспорт параметров пакета UE-V и восстановление шаблонов UE-V с помощью Windows PowerShell

  1. Откройте окно Windows PowerShell с правами администратора.

  2. Используйте следующие команды Windows PowerShell для настройки агента.

    Команда Windows PowerShell Описание
    Export-UevPackage MicrosoftCalculator6.pkgx Извлекает параметры из файла пакета калькулятора Майкрософт и преобразует их в удобочитаемый формат в ФОРМАТЕ XML.
    Repair-UevTemplateIndex Восстанавливает индекс шаблонов расположения параметров UE-V.

Настройка агента UE-V с помощью WMI

  1. Виртуализация взаимодействия с пользователем предоставляет следующий набор команд WMI. Администраторы могут использовать этот интерфейс для настройки агента UE-V в командной строке и автоматизации типичных задач конфигурации.

    Используйте учетную запись с правами администратора, чтобы открыть окно Windows PowerShell.

  2. Используйте следующие команды WMI для настройки агента.

    Команда Windows PowerShell Описание
    Get-WmiObject -Namespace root\Microsoft\UEV Configuration Отображает активные параметры агента UE-V. Пользовательские параметры имеют приоритет над параметрами компьютера.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration Отображает конфигурацию агента UE-V, определенную для пользователя.
    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration Отображает конфигурацию агента UE-V, определенную для компьютера.
    Get-WmiObject -Namespace root\Microsoft\Uev ConfigurationItem Отображает сведения для каждого элемента конфигурации.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SettingsStoragePath = <path_to_settings_storage_location>
    $config.Put()    		 Определяет расположение хранилища параметров для каждого компьютера.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration
    $config.SettingsStoragePath = <path_to_settings_storage_location>
    $config.Put()    		 Определяет расположение хранилища параметров для каждого пользователя.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds>
    $config.Put()    		 Задает время ожидания синхронизации в миллисекундах для всех пользователей компьютера.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.MaxPackageSizeInBytes = <size_in_bytes>
    $config.Put()    		 Настраивает агент UE-V так, чтобы он сообщал, когда размер файла пакета параметров достигает определенного порогового значения. Задайте пороговый размер файла пакета в байтах для всех пользователей компьютера.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.SyncMethod = <sync_method>
    $config.Put()    		 Задает метод синхронизации для всех пользователей компьютера: SyncProvider или None.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $true
    $config.Put()    		 Чтобы включить определенный параметр для каждого компьютера, очистите параметр и используйте $null в качестве значения параметра. Используйте UserConfiguration для параметров для каждого пользователя.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $false
    $config.Put()    		 Чтобы отключить определенный параметр для каждого компьютера, очистите параметр и используйте $null в качестве значения параметра. Используйте конфигурацию пользователя для параметров для каждого пользователя.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 Обновляет определенный параметр для каждого компьютера. Чтобы очистить параметр, используйте $null в качестве значения параметра.
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 Обновляет определенный параметр для каждого пользователя для всех пользователей компьютера. Чтобы очистить параметр, используйте $null в качестве значения параметра.

После настройки агента UE-V с WMI и Windows PowerShell определенная конфигурация сохраняется в реестре в следующих расположениях.

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

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

Экспорт параметров пакета UE-V и восстановление шаблонов UE-V с помощью WMI

  1. UE-V предоставляет следующий набор команд WMI. Администраторы могут использовать этот интерфейс для экспорта пакета или восстановления шаблонов UE-V.

  2. Используйте следующие команды WMI.

    Команда WMI Описание
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserSettings -Name ExportPackage -ArgumentList <package name> Извлекает параметры из файла пакета и преобразует их в удобочитаемый формат в ФОРМАТЕ XML.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name RebuildIndex Восстанавливает индекс шаблонов расположения параметров UE-V. Должен быть запущен от имени администратора.

Администрирование UE-V 2.1 с пакетом обновления 1 (SP1) с помощью Windows PowerShell и WMI

Администрирование UE-V 2.1 с пакетом обновления 1 (SP1)