使用 Windows PowerShell 和 WMI (Windows 10) 管理 UE-V 設定位置範本

用戶體驗虛擬化 (UE-V) 使用 XML 設定位置範本來定義使用者體驗虛擬化所擷取並套用的設定。 UE-V 包含一組標準設定位置範本。 它也包含可讓您建立自定義設定位置範本的 UE-V 範本產生器工具。 建立及部署設定位置範本之後，您可以使用 Windows PowerShell 和 Windows Management Instrumentation (WMI) 來管理這些範本。

注意

如需 UE-V Cmdlet 的完整清單，請參閱 Windows PowerShell 中的使用者體驗虛擬化。

使用 Windows PowerShell 管理 UE-V 設定位置範本

UE-V 的 WMI 和 Windows PowerShell 功能包括啟用、停用、註冊、更新和取消註冊設定位置範本的能力。 藉由使用這些功能，您可以自動化向 UE-V 服務註冊、更新或取消註冊範本的程式。 您也可以使用 WMI 和 Windows PowerShell 命令手動註冊範本。 藉由使用這些功能搭配電子軟體發佈解決方案、群組原則 或其他自動化部署方法，例如腳本，您可以進一步自動化該程式。

您必須具有系統管理員許可權，才能更新、註冊或取消註冊設定位置範本。 不需要系統管理員許可權，即可啟用、停用或列出範本。

若要使用 Windows PowerShell 來管理設定位置範本

1. 使用具有系統管理員許可權的帳戶開啟 Windows PowerShell 命令提示字元。

2. 使用下列 Windows PowerShell Cmdlet 來註冊和管理 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 架構。 路徑必須是範本檔案的完整路徑，但不包括通配符。

UE-V Windows PowerShell 功能可讓您管理部署在企業中的一組設定範本。 使用下列程式，使用 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 這兩個參數，此 Cmdlet 會傳回在使用者或計算機層級設定的 Windows 應用程式清單。

屬性的定義

PackageFamilyName

為目前使用者安裝的套件名稱。

啟用

定義應用程式的設定是否設定為同步處理指定的交換器，也就是 使用者 或 計算機。

安裝

如果應用程式為目前使用者安裝 PackageFamilyName，則為 True。

使用 WMI 管理 UE-V 設定位置範本

User Experience Virtualization 提供下列一組 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>"。

相關主題

在 Windows PowerShell 中使用 Windows PowerShell 和 WMI管理 UE-V用戶體驗虛擬化來管理 UE-V