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

您可以使用 WMI 和 PowerShell 來管理 Microsoft 消費者體驗虛擬化 (UE-V) 代理程式設定和同步處理行為。

如何使用 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 設定 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 < path to _settings_storage_location>

    定義每部電腦的設定儲存位置。

    Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath < path to _settings_storage_location>

    定義每位使用者設定儲存位置。

    Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds < 逾時以毫秒為單位>

    以毫秒為單位設定同步處理逾時

    Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds < 逾時以毫秒為單位>

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

    Set-UevConfiguration -Computer -MaxPackageSizeInBytes < 大小,以位元組為單位>

    將 UE-V 代理程式設定為在設定套件檔案大小達到定義的臨界值時報告。 以位元組為單位設定閾值套件大小。

    Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes < 大小,以位元組為單位>

    設定目前使用者的套件大小警告閾值。

    Set-UevConfiguration –電腦 –SettingsTemplateCatalogPath < 目錄路徑>

    設定設定範本目錄路徑。

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

    設定同步處理方法:OfflineFiles 或 None。

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

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

    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 – 電腦 - < 設定名稱>

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

    Clear-UevConfiguration –CurrentComputerUser - < setting name>

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

    <Export-UevConfiguration設定移轉檔案>

    將 UE-V 電腦群組態匯出至設定移轉檔案。 檔案的副檔名必須是 「.uev」。

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

    <Import-UevConfiguration設定移轉檔案>

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

如何使用 PowerShell 匯出 UE-V 套件設定及修復 UE-V 範本

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

    Import-module UEV
    
  2. 使用下列 PowerShell 命令來設定代理程式。

    PowerShell 命令

    說明

    Export-UevPackage MicrosoftCalculator6.pkgx

    從Microsoft 小算盤封裝檔案擷取設定,並以 XML 將它們轉換成人類可讀取的格式。

    Repair-UevTemplateIndex

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

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

  1. User Experience Virtualization 提供下列一組 WMI 命令。 系統管理員可以使用此介面,從命令列設定 UE-V 代理程式,並將一般設定工作自動化。

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

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

    PowerShell 命令 說明

    Get-WmiObject -Namespace root\Microsoft\UEV 組態

    檢視使用中的 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 或 None。

    $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 作業