共用方式為

使用 PowerShell 與 WMI 來管理 UE-V 1.0 設定位置範本

  • 發行項

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

使用 WMI 和 PowerShell 管理設定位置範本

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

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

使用 PowerShell 管理設定位置範本

  1. 使用具有系統管理員許可權的帳戶開啟Windows PowerShell視窗。 若要匯入 Microsoft UE-V PowerShell 模組，請在 PowerShell 命令提示字元中輸入下列命令。

    Import-module UEV

  2. 使用下列 PowerShell Cmdlet 來註冊和管理 UE-V 設定位置範本。

    PowerShell 命令 說明

    Get-UevTemplate

    列出電腦上註冊的所有設定位置範本。

    Register-UevTemplate

    向 UE-V 註冊設定位置範本。 註冊範本之後，UE-V 會同步處理已註冊範本之電腦之間範本中定義的設定。

    Unregister-UevTemplate

    使用 UE-V 取消註冊設定位置範本。 一旦範本取消註冊，UE-V 將不再同步處理電腦之間範本中定義的設定。

    Update-UevTemplate

    更新具有較新版本範本的設定位置範本。 新範本的版本應該晚于現有的版本。

    Disable-UevTemplate

    停用電腦目前使用者的設定位置範本。

    Enable-UevTemplate

    啟用電腦目前使用者的設定位置範本。

    Test-UevTemplate

    判斷指定的設定位置範本是否符合其 XML 架構。

UE-V PowerShell 功能可讓您管理部署在企業中的一組設定範本。 若要使用 PowerShell 管理一組範本，請執行下列動作。

使用 PowerShell 管理設定位置範本群組

  1. 修改或更新所需的設定位置範本。

  2. 將所需的設定位置範本部署到本機電腦可存取的資料夾。

  3. 在本機電腦上，以系統管理員許可權開啟Windows PowerShell視窗。

  4. 輸入下列命令，以匯入 Microsoft UE-V PowerShell 模組。

    Import-module UEV

  5. 輸入下列命令來取消註冊所有先前註冊的範本版本。

    Get-UevTemplate | Unregister-UevTemplate

    這會取消註冊電腦上的所有使用中範本。

  6. 輸入下列命令來註冊更新的範本。

    Register-UevTemplate <path to template folder>\*.xml

    這會註冊位於指定範本資料夾中的所有設定位置範本。

User Experience Virtualization 提供下列一組 WMI 命令。 系統管理員可以使用這些介面來管理來自Windows PowerShell的設定位置範本，並將範本管理工作自動化。

使用 WMI 管理設定位置範本

  1. 使用具有系統管理員許可權的帳戶開啟Windows PowerShell視窗。

  2. 使用下列 WMI 命令來註冊和管理 UE-V 設定位置範本。

    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 Register -ArgumentList < 範本路徑 >

    向 UE-V 註冊設定位置範本。

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name UnregisterByTemplateId -ArgumentList < 範本識別碼>

    使用 UE-V 取消註冊設定位置範本。 一旦範本取消註冊，UE-V 將不再同步處理電腦之間範本中定義的設定。

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name EnableByTemplateId -ArgumentList < 範本識別碼>

    使用 UE-V 啟用設定位置範本

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name DisableByTemplateId -ArgumentList < 範本識別碼>

    使用 UE-V 停用設定位置範本

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList < 範本路徑>

    更新 UE-V 的設定位置範本。 新範本的版本應該高於現有的版本。

    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList < 範本路徑>

    判斷指定的設定位置範本是否符合其 XML 架構。

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

  1. 在可存取的網路共用中暫存 UE-V 安裝程式檔案。

    注意 使用AgentSetup.exe部署 UE-V 代理程式的 32 位和 64 位版本。 Windows Installer Files 版本AgentSetupx86.msi和AgentSetupx64.msi適用于每個架構。 若要稍後使用安裝檔案卸載 UE-V 代理程式，您必須使用相同的檔案類型。

  2. 使用下列其中一個 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%

使用 PowerShell 與 WMI 來管理 UE-V 1.0 Agent 與套件

管理 UE-V 1.0

UE-V 1.0 作業