Share via

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

  • Статья
  • Применяется к:
    ✅ Windows 10

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

Примечание.

Полный список командлетов UE-V см. в статье Виртуализация взаимодействия с пользователем в Windows PowerShell.

Управление шаблонами расположения параметров UE-V с помощью 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> Списки все шаблоны расположения параметров, зарегистрированные на компьютере, где содержится имя приложения или имя шаблона.
    Get-UevTemplate -TemplateID <string> Списки все шаблоны расположения параметров, зарегистрированные на компьютере, где содержится идентификатор шаблона.
    Get-UevTemplate [-ApplicationOrTemplateID] <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

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, настроенных на уровне пользователя или компьютера.

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

PackageFamilyName

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

Включен

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

Установлены

Значение true, если приложение, то есть PackageFamilyName установлено для текущего пользователя.

Управление шаблонами расположения параметров UE-V с помощью 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 MachineConfiguredWindows8App Возвращает список приложений Для 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> Удаляет одно или несколько приложений Windows из списка приложений windows на компьютере.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name RemoveApp -ArgumentList <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> Отключает одно или несколько приложений Windows в списке приложений windows на компьютере.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name DisableApp -ArgumentList <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> Включает приложения Windows в списке приложений windows на компьютере.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <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 и WMI. Администрированиевиртуализации взаимодействия с пользователем UE-V в Windows PowerShell