共用方式為

Windows.Management.Update 命名空間

  • 參考
編輯

此命名空間中的類型可讓使用者加入宣告或退出在其裝置上接收Windows Insider Preview組建。 API 旨在供 IoT 原始設備製造商 (OEM) 使用。

類別

PreviewBuildsManager

管理裝置的預覽組建狀態。
PreviewBuildsState

包含用來將裝置與 Windows 測試人員計畫建立關聯之裝置的資訊。
WindowsUpdate

WindowsUpdate 基本上是屬性包，其中包含擱置或進行中更新的相關資訊。
WindowsUpdateActionCompletedEventArgs

對應 WindowsUpdateManager.ActionCompleted 事件的事件資料。
WindowsUpdateActionProgress

由WindowsUpdate和WindowsUpdateProgressChangedEventArgs的ActionProgress屬性傳回。
WindowsUpdateActionResult

由 WindowsUpdate.ActionResult屬性傳回。
WindowsUpdateAdministrator

啟用在裝置上管理 Windows 更新。
WindowsUpdateApprovalData

允許透過 ApprovWindowsUpdate核准更新時，在更新上設定其他中繼資料。
WindowsUpdateAttentionRequiredInfo

代表 WindowsUpdateAttentionRequiredReason 和時間戳記的元組。
WindowsUpdateAttentionRequiredReasonChangedEventArgs

對應 WindowsUpdateManager.AttentionRequiredReasonChanged 事件的事件資料。
WindowsUpdateGetAdministratorResult

表示呼叫 GetRegisteredAdministrator的結果。
WindowsUpdateItem

代表先前完成之更新的相關資訊屬性包。
WindowsUpdateManager

用來透過回呼監視更新活動的介面，以及擷取更新歷程記錄。
WindowsUpdateProgressChangedEventArgs

對應 WindowsUpdateManager.ProgressChanged 事件的事件資料。
WindowsUpdateRestartRequestOptions

代表可設定的欄位屬性包，然後傳遞至 RequestRestart。
WindowsUpdateScanCompletedEventArgs

對應 WindowsUpdateManager.ScanCompleted 事件的事件資料。

列舉

WindowsUpdateAdministratorOptions

定義常數，指定呼叫端在向 RegisterForAdministration註冊時想要控制的系統管理員選項。
WindowsUpdateAdministratorStatus

定義常數，指定狀態碼以指出 Windows Update 系統管理員的註冊/取消註冊是否成功。
WindowsUpdateAttentionRequiredReason

定義常數，指定更新需要注意的原因，才能繼續。

範例

此 C# 範例示範使用者如何判斷其裝置是否接收預覽版，或是否有問題防止裝置取得預覽組建。

public string GetErrorMessage() 
{ 
    PreviewBuildsManager manager = PreviewBuildsManager.GetDefault(); 
    if (manager != null) 
    { 
        PreviewBuildsState state = manager.GetCurrentState(); 
        if (state.Properties.ContainsKey("ErrorMessage")) 
        { 
            return state.Properties["ErrorMessage"].ToString(); 
        } 
    } 
    return String.Empty; 
}

備註

這些 API 可讓 IoT 裝置接收Windows Insider Preview組建。 裝置的 OEM 預期會在 Windows Device Portal 中建立裝置組態屬性的設定頁面。 概括而言， PreviewBuildsState 的資訊將由裝置讀取，然後向使用者顯示，然後用來向裝置註冊使用者帳戶。 註冊之後，所有設定管理都會透過 Windows 測試人員計畫線上完成，而不是在裝置本身上進行。