共用方式為

使用 Windows PowerShell 和 WMI 管理 UE-V 2.x 設定位置範本

  • 發行項

適用於: User Experience Virtualization 2.0, User Experience Virtualization 2.1

Microsoft User Experience Virtualization (UE-V) 2.0 2.1 和 2.1 SP1 使用 XML 設定位置範本來定義 使用者經驗虛擬化 擷取及套用的設定。UE-V 包含一組標準設定位置範本。它也包含 UE-V Generator 工具，可讓您建立自訂設定位置範本。建立及部署設定位置範本之後，您可以使用 Windows PowerShell 和 Windows Management Instrumentation (WMI) 管理這些範本。如需完整的 UE-V PowerShell Cmdlet 清單，請參閱 UE-V 2 Cmdlet 參考 (https://go.microsoft.com/fwlink/p/?LinkId=393495)。

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

Windows PowerShell 的 WMI 和 UE-V 功能包括啟用、停用、登錄、更新及取消登錄設定位置範本的功能。使用這些功能，您可以使用 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>

    列出已在範本 ID 包含 <字串> 的電腦上，登錄的所有設定位置範本。

    Get-UevTemplate [-ApplicationOrTemplateID] <string>

    列出已在應用程式或範本名稱或範本 ID 包含 <字串> 的電腦上，登錄的所有設定位置範本。

    Get-UevTemplateProgram [-ID] <template ID>

    取得程式名稱和版本資訊 (這取決於範本 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 屬性的定義

  • 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)，Cmdlet 會傳回已在使用者或電腦層級設定的 Windows 應用程式清單。

屬性的定義

  • DisplayName
    在 [公司設定中心] 應用程式中對使用者顯示的名稱。DisplayName 屬性是衍生自 PackageFamilyName 屬性。
  • PackageFamilyName
    為目前的使用者安裝的套件名稱。
  • 已啟用
    定義應用程式的設定是否已設定為針對指定的參數 (即 user 或 computer) 進行同步處理。
  • Installed
    如果已為目前的使用者安裝應用程式 (即 PackageFamilyName) 則為 True。

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

使用者經驗虛擬化 提供下列幾組 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 | 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>"。

使用 Windows PowerShell 部署 UE-V 代理程式

如何使用 Windows PowerShell 部署 UE-V 代理程式

  1. 將 UE-V 代理程式安裝封裝放在可存取的網路共用中。

    注意

    使用 AgentSetup.exe 來部署 32 位元和 64 位元版本的 UE-V 代理程式。Windows Installer 封裝、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 方面的問題嗎？請利用 UE-V TechNet 論壇。

另請參閱

其他資源

使用 Windows PowerShell 和 WMI 管理 UE-V 2.x
管理 UE-V 2.x