Share via

Управление агентом и пакетами UE-V 2.x с помощью Windows PowerShell и WMI

  • Статья

Назначение: User Experience Virtualization 2.0, User Experience Virtualization 2.1

Инструментарий управления Windows (WMI) и Windows PowerShell можно использовать для управления конфигурацией и режимом синхронизации агента Microsoft User Experience Virtualization (UE-V) 2.0, 2.1 и 2.1 с пакетом обновления 1 (SP1). Полный список командлетов PowerShell UE-V см. в разделе Справочник по командлетам UE-V 2 (https://go.microsoft.com/fwlink/?LinkId=393495).

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

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

    Примечание

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

  2. Используйте одну из указанных ниже команд Windows PowerShell, чтобы установить агент UE-V.

    • & 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. Для управления настройками компьютера, влияющими на всех пользователей компьютера с помощью параметра Компьютер, откройте окно с учетной записью, имеющей права администратора.

  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 для всех пользователей компьютера. Дополнительные сведения см. в разделе Get-UevAppxPackage в Управление шаблонами расположений параметров UE-V 2.x с помощью Windows PowerShell и WMI.

    Используйте параметр DisableSyncUnlistedWindows8Apps для настройки агента UE-V для синхронизации только тех приложений Windows, которые явно включены в список приложений Windows.

    Set-UevConfiguration - CurrentComputerUser - EnableSyncUnlistedWindows8Apps

    Настраивает агент UE-V для синхронизации всех приложений Windows, которые явно не отключены в списке приложений Windows для текущего пользователя на компьютере. Дополнительные сведения см. в разделе Get-UevAppxPackage в Управление шаблонами расположений параметров UE-V 2.x с помощью Windows PowerShell и WMI.

    Используйте параметр 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, которые можно настроить с параметром Компьютер.

    Import-UevConfiguration <settings migration file>

    Импортирует конфигурации компьютера UE-V из файла миграции параметров. Расширение имени файла должно быть UEV.

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

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

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

    Windows PowerShell команда

    Описание

    Export-UevPackage MicrosoftCalculator6.pkgx

    Извлечение параметров из файла пакета программы Калькулятор (Майкрософт) и преобразование в читаемый формат XML.

    Repair-UevTemplateIndex

    Восстановление индекса шаблонов расположений параметров UE-V.

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

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

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

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

    Windows PowerShell command Описание

    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 в качестве его значения. Конфигурация пользователя используется для настройки параметров на уровне пользователя.

    $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.<имя параметра> = <значение параметра>

    $config.Put()

    Обновление параметров конкретного пользователя для всех пользователей компьютера. Чтобы сбросить параметр, используйте $null в качестве его значения.

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

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

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

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

  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? Выдвигайте предложения и голосуйте за них здесь.
    Есть вопрос по UE-V? Найдите ответ на форуме TechNet по UE-V.

См. также

Другие ресурсы

Администрирование UE-V 2.x с помощью Windows PowerShell и WMI
Администрирование UE-V 2.x