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

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

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

Управление шаблонами расположений параметров UE-V 2.x с помощью Windows PowerShell

WMI и Windows PowerShell компоненты UE-V включают возможность включения, отключения, регистрации, обновления и отмены регистрации шаблонов расположений параметров. С помощью этих функций, можно автоматизировать процесс регистрации, обновления или отмены регистрации шаблонов с помощью агента UE-V. Можно также вручную зарегистрировать шаблоны с помощью инструментария WMI и команд Windows PowerShell. С помощью этих функций в сочетании с решением для распространения ПО, групповой политики или другого метода автоматического развертывания, например, сценарием, можно дополнительно автоматизировать этот процесс.

Необходимо иметь права администратора для обновления, регистрации или отмены регистрации шаблона расположений параметров. Для включение, отключения или получения списка шаблонов права администратора не требуются.

Управление шаблонами расположений параметров с помощью Windows PowerShell

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

2. Используйте следующие командлеты Windows PowerShell для регистрации и управления шаблонами расположений параметров UE-V.

   Команда Windows PowerShell	Описание
   Get-UevTemplate	Список всех шаблонов расположений параметров, зарегистрированных на компьютере.
   Get-UevTemplate –Application <string>	Список всех зарегистрированных на компьютере шаблонов расположения параметров, для которых имя приложения или шаблона содержит фрагмент <string>.
   Get-UevTemplate –TemplateID <string>	Список всех зарегистрированных на компьютере шаблонов расположения параметров, для которых идентификатор шаблона содержит фрагмент <string>.
   Get-UevTemplate [-ApplicationOrTemplateID] <string>	Список всех зарегистрированных на компьютере шаблонов расположения параметров, для которых имя приложения, имя шаблона или идентификатор шаблона содержит фрагмент <string>.
   Get-UevTemplateProgram [-ID] <template ID>	Возвращает имя программы и сведения о версии, которые зависят от идентификатора шаблона.
   Get-UevAppXPackage	Возвращает действительный список приложений Windows.
   Get-UevAppXPackage -Computer	Возвращает список приложений Windows, настроенных для компьютера.
   Get-UevAppXPackage -CurrentComputerUser	Возвращает список приложений Windows, настроенных для текущего пользователя.
   Register-UevTemplate [-Path] <template file path>[,<template file path>]	Регистрирует один или несколько шаблонов расположений параметров с UE-V, используя относительные пути и подстановочные знаки в пути к файлам. После регистрации шаблона UE-V синхронизирует параметры, определенные в шаблоне между компьютерами, которые имеют зарегистрированный шаблон.
   Register-UevTemplate –LiteralPath <template file path>[,<template file path>]	Регистрирует один или несколько шаблонов расположений параметров с UE-V, используя буквенные пути, где символы не могут интерпретироваться как подстановочные знаки. После регистрации шаблона UE-V синхронизирует параметры, определенные в шаблоне между компьютерами, которые имеют зарегистрированный шаблон.
   Unregister-UevTemplate [-ID] <template ID>	Отменяет регистрацию шаблона расположений параметров с UE-V. При отмене регистрации, шаблон UE-V больше не синхронизирует параметры, которые определены в шаблоне между компьютерами.
   Unregister-UevTemplate -All	Отменяет регистрацию всех шаблонов расположений параметров с UE-V. При отмене регистрации, шаблон UE-V больше не синхронизирует параметры, которые определены в шаблоне между компьютерами.
   Update-UevTemplate [-Path] <template file path>[,<template file path>]	Обновляет один или несколько шаблонов расположений параметров последней версией шаблона. Используйте относительные пути и подстановочные знаки в пути к файлам. Новый шаблон должен иметь более новую версию, чем существующий.
   Update-UevTemplate –LiteralPath <template file path>[,<template file path>]	Обновляет один или несколько шаблонов расположений параметров последней версией шаблона. Используйте полные пути к файлам шаблонов, где символы не могут интерпретироваться как подстановочные знаки. Новый шаблон должен иметь более новую версию, чем существующий.
   Clear-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]	Удаляет одно или несколько приложений Windows из списка приложений Windows компьютера.
   Clear-UevAppXPackage -CurrentComputerUser	Удаляет приложение Windows из списка приложений Windows текущего пользователя.
   Clear-UevAppXPackage –Computer -All	Удаляет все приложения Windows из списка приложений Windows компьютера.
   Clear-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]	Удаляет одно или несколько приложений Windows из списка приложений Windows текущего пользователя.
   Clear-UevAppXPackage [–CurrentComputerUser] -All	Удаляет все приложения Windows из списка приложений Windows текущего пользователя.
   Disable-UevTemplate [-ID] <template ID>	Отключает шаблон расположений параметров для текущего пользователя компьютера.
   Disable-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]	Отключает одно или несколько приложений Windows из списка приложений Windows компьютера.
   Disable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]	Отключает одно или несколько приложений Windows из списка приложений Windows текущего пользователя.
   Enable-UevTemplate [-ID] <template ID>	Включает шаблон расположений параметров для текущего пользователя компьютера.
   Enable-UevAppXPackage –Computer [-PackageFamilyName] <package family name>[,<package family name>]	Включает одно или несколько приложений Windows из списка приложений Windows компьютера.
   Enable-UevAppXPackage [–CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>]	Включает одно или несколько приложений Windows из списка приложений Windows текущего пользователя.
   Test-UevTemplate [-Path] <template file path>[,<template file path>]	Определяет, соответствуют ли один или несколько шаблонов расположений параметров его XML-схеме. Можно использовать относительные пути и подстановочные знаки.
   Test-UevTemplate –LiteralPath <template file path>[,<template file path>]	Определяет, соответствуют ли один или несколько шаблонов расположений параметров его XML-схеме. Путь должен быть полным путем к файлу шаблона, не поддерживаются подстановочные знаки.

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

Управление шаблонами расположений параметров с помощью Windows PowerShell

1. Измените или обновите нужные шаблоны расположений параметров.

2. Если вы хотите изменить или обновить шаблоны расположений параметров, разверните эти шаблоны расположений параметров в папку, доступную на локальном компьютере.

3. На локальном компьютере откройте окно Windows PowerShell с правами администратора.

4. Отмените регистрацию зарегистрированных ранее версий шаблонов, введя следующую команду.

   Unregister-UevTemplate -All
   

   Эта команда отменяет все активные шаблоны на компьютере.

5. Зарегистрируйте обновленные шаблоны, введя следующую команду.

   Register-UevTemplate <path to template folder>\*.xml
   

   Эта команда регистрирует все шаблоны расположений параметров, которые находятся в указанной папке.

Список приложений Windows

Добавление приложения Windows в список приложений Windows позволяет указать, включена ли синхронизация параметров для этого приложения. Приложения определяются в списке по их имени семейства пакетов и необходимости включения или отключения синхронизации параметров для этого приложения. При использовании указанных параметров вместе с параметром «Действия синхронизации по умолчанию для приложений, отсутствующих в списке» можно контролировать синхронизацию приложений Windows.

Чтобы отобразить имя семейства пакетов установленных приложений Windows, в командной строке Windows PowerShell введите:

Get-AppxPackage | Sort-Object PackageFamilyName | Format-Table PackageFamilyName

Чтобы отобразить список приложений Windows, которые могут синхронизировать параметры на компьютере, с соответствующим именем семейства пакетов, источником и состоянием включения, в командной строке Windows PowerShell введите: Get-UevAppxPackage

Определения свойств Get-UevAppxPackage

• DisplayName
  Имя, отображаемое для пользователя в приложении "Центр параметров компании". Свойство DisplayName получено из свойства PackageFamilyName.

• PackageFamilyName
  Имя пакета, установленного для текущего пользователя.

• Включено
  Определяет, настроены ли параметры приложения для синхронизации.

• EnabledSource
  Расположение, в котором задана конфигурация, включающая или отключающая приложение. Возможные значения: NotSet, LocalMachine, LocalUser, PolicyMachine и PolicyUser.

• NotSet
  Политика не настроена для синхронизации этого приложения.

• LocalMachine
  Состояние включения задано в разделе реестра для локального компьютера.

• LocalUser
  Состояние включения задано в разделе реестра для текущего пользователя.

• PolicyMachine
  Состояние включения задано в разделе политик раздела реестра для локального компьютера.

Чтобы получить настроенный для пользователя список приложений Windows, в командной строке Windows PowerShell введите: Get-UevAppxPackage –CurrentComputerUser

Чтобы получить настроенный для компьютера список приложений Windows, в командной строке Windows PowerShell введите: Get-UevAppxPackage –Computer

Для любого из параметров (CurrentComputerUser или Computer) командлет возвращает список приложений Windows, настроенных на уровне пользователя или компьютера.

Определения свойств

• DisplayName
  Имя, отображаемое для пользователя в приложении "Центр параметров компании". Свойство DisplayName получено из свойства PackageFamilyName.

• PackageFamilyName
  Имя пакета, установленного для текущего пользователя.

• Включено
  Определяет, настроены ли параметры приложения для синхронизации для указанного коммутатора, то есть user или computer.

• Установлено
  Данное условие выполняется, если приложение (PackageFamilyName) установлено для текущего пользователя.

Управление шаблонами расположений параметров UE-V 2 с помощью инструментария WMI

Виртуализация взаимодействия с пользователем обеспечивает следующий набор команд WMI. Администраторы могут использовать эти интерфейсы для управления шаблонами расположений параметров из Windows PowerShell и автоматизировать задачи администрирования шаблона.

Для управления шаблонами расположений параметров с помощью инструментария WMI

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

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

   Windows PowerShell command	Описание
   Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate | Select-Object TemplateId,TemplateName, TemplateVersion,Enabled | Format-Table -Autosize	Возвращает список всех шаблонов расположений параметров, зарегистрированных на компьютере.
   Invoke-WmiMethod –Namespace root\Microsoft\UEV –Class SettingsLocationTemplate –Name GetProcessInfoByTemplateId <template Id>	Возвращает имя программы и сведения о версии, которые зависят от имени шаблона.
   Get-WmiObject -Namespace root\Microsoft\UEV EffectiveWindows8App	Возвращает действительный список приложений Windows.
   Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration	Возвращает список приложений Windows, настроенных для компьютера.
   Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguredWindows8App	Возвращает список приложений Windows, настроенных для текущего пользователя.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Register -ArgumentList <template path >	Регистрирует шаблон расположений параметров с UE-V.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name UnregisterByTemplateId -ArgumentList <template ID>	Отменяет регистрацию шаблона расположений параметров с UE-V. Как только отменяется регистрация, шаблон UE-V больше не синхронизирует параметры, которые определены в шаблоне между компьютерами.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList <template path>	Обновляет шаблон расположений параметров с UE-V. Новый шаблон должен иметь более новую версию, чем существующий.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name | package family name>	Удаляет одно или несколько приложений Windows из списка приложений Windows компьютера.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name | package family name>	Удаляет одно или несколько приложений Windows из списка приложений Windows текущего пользователя.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name DisableByTemplateId -ArgumentList <template ID>	Отключает один или несколько шаблонов расположений параметров с UE-V.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name DisableApp -ArgumentList <package family name | package family name>	Отключает одно или несколько приложений Windows из списка приложений Windows компьютера.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name DisableApp -ArgumentList <package family name | package family name>	Отключает одно или несколько приложений Windows из списка приложений Windows текущего пользователя.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name EnableByTemplateId -ArgumentList <template ID>	Включает шаблон расположений параметров с UE-V.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name EnableApp -ArgumentList <package family name | package family name>	Включает приложения Windows в списке приложений Windows компьютера.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <package family name | package family name>	Включает приложения Windows в списке приложений Windows текущего пользователя.
   Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList <template path>	Определяет, соответствует ли шаблон расположений параметров своей схеме XML.

   Примечание

   Где список из имен пакетов семейств вызывается командой WMI, список должен быть заключен в кавычки и разделен символом вертикальной черты, например, "<package family name | package family name>".

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

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

См. также

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

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