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

Назначение: User Experience Virtualization 1.0

Для управления конфигурацией и режимом синхронизации агента Microsoft User Experience Virtualization (UE-V) можно использовать инструментарий WMI и PowerShell.

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

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

    Примечание

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

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

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

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

    Команда PowerShell

    Описание

    Get-UevConfiguration

    Просмотр действующих параметров агента UE-V. Пользовательские параметры имеют приоритет над настройками компьютера.

    Get-UevConfiguration - CurrentComputerUser

    Просмотр значений параметров UE-V только для текущего пользователя.

    Get-UevConfiguration -Computer

    Просмотр значений параметров конфигурации агента UE-V для всех пользователей на компьютере.

    Set-UevConfiguration -Computer -SettingsStoragePath <путь к_месту_хранения_параметров>

    Определение места хранения параметров для отдельного компьютера.

    Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <путь к_месту_хранения_параметров>

    Определение места хранения параметров для отдельного пользователя.

    Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <время ожидания в мс>

    Установка значения времени ожидания синхронизации в миллисекундах.

    Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <время ожидания в мс>

    Установка времени ожидания синхронизации для текущего пользователя.

    Set-UevConfiguration -Computer -MaxPackageSizeInBytes <размер в байтах>

    Настройка создания агентом UE-V предупреждения о достижении заданного порогового значения размера файла пакета параметров. Установка порогового значения размера пакета в байтах.

    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <размер в байтах>

    Установка порогового значения предупреждения о размере пакета для текущего пользователя.

    Set-UevConfiguration –Computer –SettingsTemplateCatalogPath <путь к каталогу>

    установка пути к каталогу шаблонов параметров.

    Set-UevConfiguration -Computer -SyncMethod <метод синхронизации>

    Установка метода синхронизации: OfflineFiles (Автономные файлы) или None (Нет).

    Set-UevConfiguration -CurrentComputerUser -SyncMethod <метод синхронизации>

    Установка метода синхронизации для текущего пользователя: OfflineFiles (Автономные файлы) или None (Нет).

    Set-UEVConfiguration -Computer –EnableSettingsImportNotify

    Включение уведомления, выводимого на экран при задержке импорта параметров пользователя.

    Чтобы отключить уведомления, используйте команду –DisableSettingsImportNotify.

    Set-UEVConfiguration - CurrentComputerUser -EnableSettingsImportNotify

    Включение для текущего пользователя уведомления, выводимого на экран при задержке импорта параметров пользователя.

    Чтобы отключить уведомления, используйте команду –DisableSettingsImportNotify.

    Set-UEVConfiguration -Computer -SettingsImportNotifyDelayInSeconds

    Задание времени (в секундах) перед отправкой уведомления пользователю.

    Set-UEVConfiguration - CurrentComputerUser -SettingsImportNotifyDelayInSeconds

    Задание времени (в секундах) перед отправкой уведомления текущему пользователю.

    Set-UevConfiguration –Computer –DisableSync

    Отключение UE-V для всех пользователей на компьютере.

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

    Set-UevConfiguration –CurrentComputerUser -DisableSync

    Отключение UE-V для текущего пользователя на компьютере.

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

    Clear-UevConfiguration –Computer -<имя параметра>

    Очистка определенного параметра для всех пользователей на компьютере.

    Clear-UevConfiguration –CurrentComputerUser -<имя параметра>

    Очистка определенного параметра только для текущего пользователя.

    Export-UevConfiguration <файл миграции параметров>

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

    Командлет экспорта экспортирует все параметры агента UE-V, которые поддерживают настройку с помощью параметра -computer.

    Import-UevConfiguration <файл миграции параметров>

    Импорт конфигурации компьютера UE-V из файла миграции параметров (UEV-файла).

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

  1. Откройте окно PowerShell от имени администратора. Импортируйте модуль PowerShell UE-V с помощью следующей команды:

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

    Команда PowerShell

    Описание

    Export-UevPackage MicrosoftCalculator6.pkgx

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

    Repair-UevTemplateIndex

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

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

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

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

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

    Команда 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, которая определена для компьютера.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SettingsStoragePath = <путь_к_месту_хранения_параметров>

    $config.Put()

    Определение места хранения параметров для отдельного компьютера.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    $config.SettingsStoragePath = <путь_к_месту_хранения_параметров>

    $config.Put()

    Определение места хранения параметров для отдельного пользователя.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SyncTimeoutInMilliseconds = <время_ожидания_в_мс>

    $config.Put()

    Установка значения времени ожидания синхронизации в миллисекундах.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.MaxPackageSizeInBytes = <размер_в_байтах>

    $config.Put()

    Настройка создания агентом UE-V предупреждения о достижении заданного порогового значения размера файла пакета параметров. Установка порогового значения размера файла пакета в байтах.

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SyncMethod = <метод_синхронизации>

    $config.Put()

    Установка метода синхронизации: OfflineFiles (Автономные файлы) или None (Нет).

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<имя параметра> = <значение параметра>

    $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 1.0
Операции для UE-V 1.0

-----
Дополнительные сведения о MDOP см. в библиотеке TechNet, сведения об устранении неполадок — на вики-сайте TechNet или присоединяйтесь к нам в Facebook или Twitter.
-----