共用方式為

使用 Windows PowerShell 和 WMI 管理 UE-V 2.1 SP1 設定位置範本

  • 發行項

Microsoft使用者體驗虛擬化 (UE-V) 2.1 SP1 使用 XML 設定位置範本來定義 UE-V 擷取並套用的設定。 UE-V 包含一組標準設定位置範本。 它也包含可讓您建立自定義設定位置範本的 UE-V 產生器工具。 建立和部署設定位置範本之後，您可以使用 Windows PowerShell 和 Windows Management Instrumentation (WMI) 來管理這些範本。 如需 UE-V PowerShell Cmdlet 的完整清單，請參閱 MDOP Cmdlet 參考。

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

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

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

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

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

  2. 若要註冊和管理 UE-V 設定位置範本，請使用下列 Windows PowerShell Cmdlet：

    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 架構。 路徑必須是範本檔案的完整路徑，但不包括通配符。

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 PowerShell 命令提示字元中顯示可同步處理電腦上設定及其套件系列名稱、啟用狀態和已啟用來源的 Windows 應用程式清單，請輸入： 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：為目前使用者安裝的套件名稱。

  • 已啟用：定義應用程式的設定是否設定為同步處理指定的參數，也就是 使用者 或 計算機。

  • 已安裝：如果為目前使用者安裝 ， PackageFamilyName 則為 True。

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

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>"。

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

  1. 在可存取的網路共用中暫存 UE-V 代理程式安裝套件。

    注意

    使用 AgentSetup.exe 部署 UE-V 代理程式的 32 位和 64 位版本。 Windows Installer 套件 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%

使用 Windows PowerShell 和 WMI 管理 UE-V 2.1 SP1

管理 UE-V 2.1 SP1