共用方式為

使用 Windows PowerShell 和 WMI 管理 UE-V 2.1 SP1 代理程式和套件

  • 發行項

您可以使用 Windows Management Instrumentation (WMI) 和 Windows PowerShell 來管理 Microsoft User Experience Virtualization (UE-V) 2.1 SP1 代理程式設定和同步處理行為。 如需 UE-V PowerShell Cmdlet 的完整清單，請參閱 MDOP Cmdlet 參考。

使用 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 設定 UE-V 代理程式

  1. 開啟 Windows PowerShell 視窗。 若要使用 Computer 參數來 管理會影響電腦所有使用者的電腦設定，請使用具有系統管理員許可權的帳戶開啟視窗。

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

Windows PowerShell 命令 描述
Get-UevConfiguration 取得有效的 UE-V 代理程式設定。 使用者特定設定的優先順序高於計算機設定。
Get-UevConfiguration -CurrentComputerUser 只取得目前使用者的 UE-V Agent 設定值。
Get-UevConfiguration -Computer 取得計算機上所有使用者的 UE-V 代理程式組態設定值。
Get-UevConfiguration -Details 取得每個組態設定的詳細數據。 顯示設定的設定位置，或是使用預設值。 如果目前的設定有效，則會顯示 。
Set-UevConfiguration -Computer -ContactITDescription <IT description> 設定 [公司設定中心] 中顯示的說明連結文字。
Set-UevConfiguration -Computer -ContactITUrl <string> 設定公司設定中心中說明連結的 URL。 您可以使用任何 URL 通訊協定。
Set-UevConfiguration -Computer -EnableDontSyncWindows8AppSettings 將 UE-V 代理程式設定為不同步處理電腦上所有使用者的任何 Windows 應用程式。
Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings 將 UE-V 代理程式設定為不同步處理目前電腦使用者的任何 Windows 應用程式。
Set-UevConfiguration -Computer -EnableFirstUseNotification 設定 UE-V 代理程式，以便在代理程式第一次為電腦上的所有使用者執行時顯示通知。
Set-UevConfiguration -Computer -DisableFirstUseNotification 將 UE-V 代理程式設定為不在代理程式第一次為電腦上的所有使用者執行時顯示通知。
Set-UevConfiguration -Computer -EnableSettingsImportNotify 設定 UE-V 代理程式，以在設定同步處理延遲時通知電腦上的所有使用者。 使用 DisableSettingsImportNotify 參數停用通知。
Set-UevConfiguration -CurrentComputerUser -EnableSettingsImportNotify 設定 UE-V 代理程式，以在設定同步處理延遲時通知目前的使用者。 使用 DisableSettingsImportNotify 參數停用通知。
Set-UevConfiguration -Computer -EnableSyncUnlistedWindows8Apps 設定 UE-V 代理程式，為電腦的所有使用者同步處理 Windows 應用程式清單未明確停用的所有 Windows 應用程式。 DisableSyncUnlistedWindows8Apps使用 參數來設定 UE-V 代理程式，只同步處理 Windows 應用程式清單明確啟用的 Windows 應用程式。
Set-UevConfiguration -CurrentComputerUser -EnableSyncUnlistedWindows8Apps 設定 UE-V 代理程式來同步處理電腦上目前使用者的 Windows 應用程式清單未明確停用的所有 Windows 應用程式。 DisableSyncUnlistedWindows8Apps使用 參數來設定 UE-V 代理程式，只同步處理 Windows 應用程式清單明確啟用的 Windows 應用程式。
Set-UevConfiguration -Computer -DisableSync 停用電腦上所有使用者的 UE-V。 使用 EnableSync 參數來啟用或重新啟用。
Set-UevConfiguration -CurrentComputerUser -DisableSync 停用電腦上目前使用者的 UE-V。 使用 EnableSync 參數來啟用或重新啟用。
Set-UevConfiguration -Computer -EnableTrayIcon 為電腦的所有使用者啟用通知區域中的 UE-V 圖示。 使用 DisableTrayIcon 參數停用圖示。
Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes> 設定 UE-V 代理程式，以在設定套件檔案大小達到計算機上所有使用者的已定義閾值時報告。 以位元組為單位設定閾值套件大小。
Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes> 將 UE-V 代理程式設定為在設定套件檔案大小達到定義的臨界值時報告。 設定目前使用者的套件大小警告閾值。
Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds 指定使用者收到電腦所有使用者通知前幾秒的時間。
Set-UevConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds 指定傳送目前使用者通知之前以秒為單位的時間。
Set-UevConfiguration -Computer -SettingsStoragePath <path to settings storage location> 為電腦的所有使用者定義每部計算機設定儲存位置。
Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to settings storage location> 定義每位用戶設定儲存位置。
Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <path to catalog> 設定計算機所有用戶的設定範本目錄路徑。
Set-UevConfiguration -Computer -SyncMethod <sync method> 設定電腦所有使用者的同步處理方法：SyncProvider 或 None。
Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method> 設定目前使用者的同步處理方法：SyncProvider 或 None。
Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds> 設定電腦所有使用者的同步處理逾時，以毫秒為單位。
Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds> 設定目前使用者的同步處理逾時。
Clear-UevConfiguration -Computer -<setting name> 清除電腦上所有使用者的指定設定。
Clear-UevConfiguration -CurrentComputerUser -<setting name> 僅清除目前使用者的指定設定。
Export-UevConfiguration <settings migration file> 將 UE-V 計算機組態匯出至設定移轉檔案。 延伸名稱必須是 .uev。 Export Cmdlet 會導出所有可使用 Computer 參數設定的 UE-V 代理程式設定。
Import-UevConfiguration <settings migration file> 從設定移轉檔案匯入 UE-V 計算機組態。 延伸名稱必須是 .uev。

使用 Windows PowerShell 導出 UE-V 套件設定並修復 UE-V 範本

  1. 以系統管理員身分開啟 Windows PowerShell 視窗。

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

    Windows PowerShell 命令 描述
    Export-UevPackage MicrosoftCalculator6.pkgx 從Microsoft計算機套件檔案擷取設定，並以 XML 將它們轉換成人類可讀取的格式。
    Repair-UevTemplateIndex 修復 UE-V 設定位置範本的索引。

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

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

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

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

    Windows 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 代理程式組態。
    Get-WmiObject -Namespace root\Microsoft\Uev ConfigurationItem 顯示每個組態專案的詳細數據。
    $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()    		 設定電腦所有使用者的同步處理方法：SyncProvider 或 None。
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $true
    $config.Put()    		 若要啟用特定的每部計算機設定，請清除設定，並使用 $null 作為設定值。 針對每位用戶設定使用UserConfiguration。
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = $false
    $config.Put()    		 若要停用特定的每部計算機設定，請清除設定，並使用 $null 作為設定值。 針對每位用戶設定使用用戶設定。
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 更新特定的每部計算機設定。 若要清除設定， 請使用 $null 做為設定值。
    $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration
    $config.<setting name> = <setting value>
    $config.Put()    		 更新電腦所有使用者的特定每一用戶設定。 若要清除設定， 請使用 $null 做為設定值。

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

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

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

若要匯出 UE-V 套件設定，並使用 WMI 修復 UE-V 範本

  1. UE-V 提供下列一組 WMI 命令。 系統管理員可以使用此介面來導出套件或修復 UE-V 範本。

  2. 使用下列 WMI 命令。

    WMI 命令 描述
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserSettings -Name ExportPackage -ArgumentList <package name> 從封裝檔案擷取設定，並將其轉換成 XML 中人類可讀取的格式。
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name RebuildIndex 修復 UE-V 設定位置範本的索引。 必須以系統管理員身分執行。

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

管理 UE-V 2.1 SP1