Поделиться через


Управление шаблонами расположения параметров 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

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

  2. Чтобы зарегистрировать шаблоны расположения параметров 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

  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: состояние 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 и автоматизации задач администрирования шаблонов.

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

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

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

    Примечание.

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

  2. Чтобы установить агент 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

Администрирование UE-V 2.1 с пакетом обновления 1 (SP1)