共用方式為

使用 PowerShell 和 WMI 管理 UE-V 1.0 代理程式和封裝

  • 發行項

適用於: User Experience Virtualization 1.0

您可以使用e WMI 和 PowerShell 來管理 Microsoft User Experience Virtualization (UE-V) 代理程式設定和同步處理行為。

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

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

    注意

    使用 AgentSetup.exe 來部署 32 位元和 64 位元版本的 UE-V 代理程式。 Windows Installer 檔案版本、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 設定 UE-V 代理程式

  1. 使用具有系統管理員權限的帳戶開啟 PowerShell 視窗。 使用下列命令匯入 UE-V PowerShell 模組。

    Import-module UEV

  2. 使用下列 PowerShell 命令設定代理程式。

    PowerShell 命令

    說明

    Get-UevConfiguration

    檢視有效的 UE-V 代理程式設定。 使用者特定的設定優先於電腦設定。

    Get-UevConfiguration - CurrentComputerUser

    檢視只適用於目前使用者的 UE-V 代理程式設定值。

    Get-UevConfiguration -Computer

    檢視電腦上所有使用者的 UE-V 代理程式組態設定值。

    Set-UevConfiguration -Computer -SettingsStoragePath <_settings_storage_location 的路徑>

    定義個別電腦的設定儲存位置。

    Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <_settings_storage_location 的路徑>

    定義個別使用者的設定儲存位置。

    Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <逾時時間 (毫秒)>

    設定同步處理逾時 (毫秒)

    Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <逾時 (毫秒)>

    設定目前使用者的同步處理逾時。

    Set-UevConfiguration -Computer -MaxPackageSizeInBytes <大小 (位元組)>

    將 UE-V 代理程式設定為當設定封裝檔案大小達到定義的閾值時回報。 設定閾值封裝大小 (位元組)。

    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <大小 (位元組)>

    設定目前使用者的封裝大小警告閾值。

    Set-UevConfiguration –Computer –SettingsTemplateCatalogPath <類別目錄的路徑>

    設定設定範本類別目錄路徑。

    Set-UevConfiguration -Computer -SyncMethod <同步處理方法>

    設定同步處理方法： OfflineFiles 或無。

    Set-UevConfiguration -CurrentComputerUser -SyncMethod <同步處理方法>

    設定目前使用者的同步處理方法。 OfflineFiles 或無。

    Set-UEVConfiguration -Computer –EnableSettingsImportNotify

    當使用者設定的匯入延遲時發出通知。

    使用 –DisableSettingsImportNotify 來停用通知。

    Set-UEVConfiguration - CurrentComputerUser -EnableSettingsImportNotify

    當使用者設定的匯入延遲時啟用目前使用者的通知。

    使用 –DisableSettingsImportNotify 來停用通知。

    Set-UEVConfiguration -Computer -SettingsImportNotifyDelayInSeconds

    指定通知使用者前的時間 (秒)

    Set-UEVConfiguration - CurrentComputerUser -SettingsImportNotifyDelayInSeconds

    指定通知目前使用者前的時間 (秒)。

    Set-UevConfiguration –Computer –DisableSync

    停用電腦上所有使用者的 UE-V。

    使用 –EnableSync 啟用或重新啟用。

    Set-UevConfiguration –CurrentComputerUser -DisableSync

    停用電腦上目前使用者的 UE-V。

    使用 –EnableSync 啟用或重新啟用。

    Clear-UevConfiguration –Computer -<設定名稱>

    清除電腦上所有使用者的特定設定。

    Clear-UevConfiguration –CurrentComputerUser -<設定名稱>

    只清除目前使用者的特定設定。

    Export-UevConfiguration <設定移轉檔案>

    將 UE-V 電腦設定匯出到設定移轉檔案。 檔案的副檔名必須為 ".uev"。

    匯出 Cmdlet 會將所有可使用 -computer 參數設定的 UE-V 代理程式設定匯出。

    Import-UevConfiguration <設定移轉檔案>

    從設定移轉檔案 (.uev 檔案) 匯入 UE-V 電腦設定。

如何使用 PowerShell 匯出 UE-V 封裝設定並修復 UE-V 範本

  1. 以系統管理員身分開啟 PowerShell 視窗。 使用下列命令匯入 UE-V PowerShell 模組。

    Import-module UEV

  2. 使用下列 PowerShell 命令設定代理程式。

    PowerShell 命令

    說明

    Export-UevPackage MicrosoftCalculator6.pkgx

    從 Microsoft Calculator 封裝檔案擷取設定，並將這些設定轉換為容易理解的 XML 格式。

    Repair-UevTemplateIndex

    修復 UE-V 設定位置範本的索引。

如何使用 WMI 設定 UE-V 代理程式

  1. 使用者經驗虛擬化 提供下列幾組 WMI 命令。 系統管理員可以使用此介面從命令列設定 UE-V 代理程式，以及自動化常用的設定工作。

    使用具有系統管理員權限的帳戶開啟 PowerShell 視窗。

  2. 使用下列 WMI 命令設定代理程式。

    PowerShell 命令 說明

    Get-WmiObject -Namespace root\Microsoft\UEV Configuration

    檢視使用中的 UE-V 代理程式設定。 使用者特定的設定優先於電腦設定。

    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    檢視為使用者定義的 UE-V 代理程式設定。

    Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    檢視為電腦定義的 UE-V 代理程式設定。

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SettingsStoragePath = <path_to_settings_storage_location>

    $config.Put()

    定義個別電腦的設定儲存位置。

    $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration

    $config.SettingsStoragePath = <path_to_settings_storage_location>

    $config.Put()

    定義個別使用者的設定儲存位置。

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds>

    $config.Put()

    設定同步處理逾時 (毫秒)。

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.MaxPackageSizeInBytes = <size_in_bytes>

    $config.Put()

    將 UE-V 代理程式設定為當設定封裝檔案大小達到定義的閾值時回報。 設定閾值封裝檔案大小 (位元組)。

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.SyncMethod = <sync_method>

    $config.Put()

    設定同步處理方法： OfflineFiles 或無。

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<設定名稱> = <設定值>

    $config.Put()

    更新特定的個別電腦設定。 若要清除設定，請使用 $null 做為設定值。

    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration

    $config.<設定名稱> = <設定值>

    $config.Put()

    更新特定的個別使用者設定。 若要清除設定，請使用 $null 做為設定值。

    使用 WMI 和 PowerShell 設定 UE-V 代理程式時，定義的設定會儲存在登錄的下列位置：

    \HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\UEV\Agent\Configuration

    \HKEY_CURRENT_USER\SOFTWARE\Microsoft\UEV\Agent\Configuration

另請參閱

其他資源

管理 UE-V 1.0
UE-V 1.0 的作業

-----
您可以透過 TechNet Library 深入瞭解 MDOP、在 TechNet Wiki 上搜尋疑難排解資訊，或是透過 Facebook 或 Twitter 追蹤我們的動態。
-----