Управление шаблонами расположения параметров UE-V 2.1 с пакетом обновления 1 (SP1) с помощью Windows PowerShell и WMI
Microsoft User Experience Virtualization (UE-V) 2.1 с пакетом обновления 1 (SP1) использует шаблоны расположения параметров XML для определения параметров, которые фиксирует и применяет UE-V. UE-V включает набор стандартных шаблонов расположения параметров. Он также включает средство генератора UE-V, которое позволяет создавать настраиваемые шаблоны расположения параметров. После создания и развертывания шаблонов расположения параметров вы можете управлять ими с помощью Windows PowerShell и инструментария управления Windows (WMI). Полный список командлетов PowerShell UE-V см. в справочнике по командлетам MDOP.
Управление шаблонами расположения параметров UE-V 2 с помощью Windows PowerShell
Функции WMI и Windows PowerShell в UE-V включают возможность включения, отключения, регистрации, обновления и отмены регистрации шаблонов расположения параметров. С помощью этих функций можно автоматизировать процесс регистрации, обновления или отмены регистрации шаблонов с помощью агента UE-V. Вы также можете вручную зарегистрировать шаблоны с помощью команд WMI и Windows PowerShell. Используя эти функции с электронным решением для распространения программного обеспечения, групповой политикой или другим автоматизированным методом развертывания, например скриптом, можно автоматизировать этот процесс.
Для обновления, регистрации или отмены регистрации шаблона расположения параметров необходимо иметь разрешения администратора. Разрешения администратора не требуются для включения, отключения или создания списка шаблонов.
Управление шаблонами расположения параметров с помощью Windows PowerShell
Используйте учетную запись с правами администратора, чтобы открыть командную строку Windows PowerShell.
Чтобы зарегистрировать шаблоны расположения параметров UE-V и управлять ими, используйте следующие командлеты Windows PowerShell:
Команда 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
Измените или обновите нужные шаблоны расположения параметров.
Если вы хотите изменить или обновить шаблоны расположения параметров, разверните эти шаблоны расположения параметров в папке, доступной локальному компьютеру.
На локальном компьютере откройте окно Windows PowerShell с правами администратора.
Отмените регистрацию всех ранее зарегистрированных версий шаблонов, введя следующую команду.
Unregister-UevTemplate -All
Эта команда отменяет регистрацию всех активных шаблонов на компьютере.
Зарегистрируйте обновленные шаблоны, введя следующую команду.
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: состояние enabled задается в разделе локального компьютера реестра.
LocalUser: состояние enabled задается в разделе текущего пользователя реестра.
PolicyMachine: состояние enabled задается в разделе политики раздела локального компьютера реестра.
Чтобы получить настроенный пользователем список приложений Windows, в командной строке Windows PowerShell введите: Get-UevAppxPackage -CurrentComputerUser
Чтобы получить список приложений Windows, настроенных на компьютере, в командной строке Windows PowerShell введите: Get-UevAppxPackage -Computer
Для любого из параметров CurrentComputerUser или Computer командлет возвращает список приложений Для Windows, настроенных на уровне пользователя или компьютера.
Определения свойств
DisplayName: имя, отображаемое пользователю в приложении Центр параметров компании. Свойство
DisplayName
является производнымPackageFamilyName
от свойства .PackageFamilyName: имя пакета, установленного для текущего пользователя.
Включено. Определяет, настроены ли параметры приложения для синхронизации для указанного коммутатора, то есть пользователя или компьютера.
Установлено: значение True, если
PackageFamilyName
установлено для текущего пользователя.
Управление шаблонами расположения параметров UE-V 2 с помощью WMI
UE-V предоставляет следующий набор команд WMI. Администраторы могут использовать эти интерфейсы для управления шаблонами расположения параметров из Windows PowerShell и автоматизации задач администрирования шаблонов.
Используйте учетную запись с правами администратора, чтобы открыть окно Windows PowerShell.
Используйте следующие команды WMI для регистрации шаблонов расположения параметров UE-V и управления ими.
Команда Windows PowerShell Описание 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 \ | 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 в доступной сетевой папке.
Примечание.
Используйте AgentSetup.exe для развертывания 32- и 64-разрядных версий агента UE-V. Пакеты установщика Windows, AgentSetupx86.msi и AgentSetupx64.msi, доступны для каждой архитектуры. Чтобы позже удалить агент UE-V с помощью файла установки, необходимо использовать тот же тип файла.
Чтобы установить агент 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 2.1 с пакетом обновления 1 (SP1) с помощью Windows PowerShell и WMI