EnrollmentStatusTracking CSP

  • 發行項

下表顯示 Windows 的適用性：

版本 Windows 10 Windows 11
Home 是 是
專業版 是 是
Windows SE 否 是
商務 是 是
企業 是 是
教育版 是 是

在 Autopilot 部署期間，您可以設定註冊狀態頁面 (ESP) ，以封鎖裝置使用，直到安裝必要的應用程式為止。 您可以選取在使用裝置之前必須安裝的應用程式。 Intune 的代理程式會使用 EnrollmentStatusTracking 設定服務提供者 (CSP) ，例如 SideCar 來設定 ESP 來封鎖裝置使用，直到安裝所需的 Win32 應用程式為止。 它會追蹤必要原則提供者及其安裝的應用程式的安裝狀態，並將其傳送至 ESP，這會向使用者顯示安裝進度訊息。 如需 ESP 的詳細資訊，請參閱 Windows Autopilot 註冊狀態頁面。

ESP 會使用 EnrollmentStatusTracking CSP 以及 DMClient CSP 來追蹤不同應用程式的安裝。 EnrollmentStatusTracking CSP 會追蹤 Win32 應用程式安裝，DMClient CSP 會追蹤 MSI 和 通用 Windows 平台 應用程式安裝。 在 DMClient CSP 中， FirstSyncStatus/ExpectedMSIAppPackages 和 FirstSyncStatus/ExpectedModernAppPackages 節點會列出要追蹤其安裝的應用程式。 如需詳細資訊，請參閱 DMClient CSP。

EnrollmentStatusTracking CSP 已在 Windows 10 1903 版中新增。

下列顯示樹狀結構格式的 EnrollmentStatusTracking CSP。

./User/Vendor/MSFT
EnrollmentStatusTracking
----Setup
--------Apps
------------PolicyProviders
----------------ProviderName
--------------------TrackingPoliciesCreated
------------Tracking
----------------ProviderName
--------------------AppName
------------------------TrackingUri
------------------------InstallationState
------------------------RebootRequired
--------HasProvisioningCompleted


./Device/Vendor/MSFT
EnrollmentStatusTracking
----DevicePreparation
--------PolicyProviders
------------ProviderName
----------------InstallationState
----------------LastError
----------------Timeout
----------------TrackedResourceTypes
--------------------Apps
----Setup
--------Apps
------------PolicyProviders
----------------ProviderName
--------------------TrackingPoliciesCreated
------------Tracking
----------------ProviderName
--------------------AppName
------------------------TrackingUri
------------------------InstallationState
------------------------RebootRequired
--------HasProvisioningCompleted

./Vendor/MSFT 針對裝置內容，請使用 ./Device/Vendor/MSFT 路徑，而針對用戶內容，請使用 ./User/Vendor/MSFT 路徑。

EnrollmentStatusTracking 必填。 CSP 的根節點。 用戶內容和裝置內容都支援此節點。 提供用來傳達 ESP 必須封鎖之原則的設定。 使用這些設定時，原則提供者會自行註冊，以及必須追蹤的原則集合。 ESP 會在向用戶顯示的狀態消息中包含這些原則設定的計數。 它也會封鎖 ESP，直到布建所有原則為止。 原則提供者預期會藉由更新適當的節點值來驅動狀態更新，然後這些值會反映在 ESP 狀態消息中。

範圍是永久性的。 支援的操作為 [取得]。

EnrollmentStatusTracking/DevicePreparation 必填。 只有裝置內容才支援此節點。 指定 ESP 在裝置準備階段讀取的設定。 在 ESP 的裝置設定階段布建裝置之前，這些設定可用來協調任何安裝活動。

範圍是永久性的。 支援的操作為 [取得]。

EnrollmentStatusTracking/DevicePreparation/PolicyProviders 必填。 只有裝置內容才支援此節點。 向 ESP 指出它應該在裝置準備階段等候，直到所有原則提供者將其 InstallationState 節點設定為 2 (NotRequired) 或 3 (Completed) 。

範圍是永久性的。 支援的操作為 [取得]。

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName 選。 只有裝置內容才支援此節點。 表示 ESP 的原則提供者。 應該為節點指定原則提供者的唯一名稱。 原則提供者的註冊會向 ESP 指出它應該在裝置準備階段封鎖，直到提供者將其 InstallationState 節點設定為 2 (NotRequired) 或 3 (Completed) 。 一旦所有已註冊的原則提供者都標示為 [已完成] 或 [未取得]，ESP 就會進入裝置設定階段。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/InstallationState 必填。 只有裝置內容才支援此節點。 將原則提供者安裝狀態傳達回 ESP。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

值類型為整數。 預期的值如下：

  • 1— NotInstalled
  • 2— NotRequired
  • 3— 已完成
  • 4— 錯誤

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/LastError 必填。 只有裝置內容才支援此節點。 表示應用程式安裝程式期間的最後一個錯誤碼。 如果無法安裝原則提供者，可以選擇性地設定ESP可以在錯誤訊息中顯示給使用者的HRESULT錯誤碼。 只有當提供者的 InstallationState 節點設定為 4 時，ESP 才會讀取此節點 (錯誤) 。 此節點只能由原則提供者設定，而非由 MDM 伺服器設定。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

值類型為整數。

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/Timeout 選。 只有裝置內容才支援此節點。 表示提供者安裝程式在 ESP 顯示錯誤之前可以執行的時間量，以分鐘為單位。 當 InstallationState 節點設定為 2 (NotRequired) 或 3 (Completed) 時，提供者安裝就會完成。 如果未指定逾時值，ESP 會選取預設的逾時值 15 分鐘。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

值類型為整數。 預設值為15分鐘。

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/TrackedResourceTypes 必填。 只有裝置內容才支援此節點。 此節點的子系會註冊原則提供者支援布建的資源類型。 只有特定資源類型的已註冊提供者會將其原則併入 ESP 追蹤訊息中。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/TrackedResourceTypes/Apps 必填。 只有裝置內容才支援此節點。 此節點會指定是否已註冊原則提供者以進行應用程式佈建。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

實值類型為布爾值。 預期的值如下：

  • false— 指出原則提供者未註冊應用程式佈建。 這是預設值。
  • true— 指出已註冊原則提供者以進行應用程式佈建。

EnrollmentStatusTracking/Setup 必填。 用戶內容和裝置內容都支援此節點。 提供ESP在裝置內容中用戶內容和裝置設定階段的帳戶設定階段期間讀取的設定。 原則提供者會使用此節點將進度狀態傳達回ESP，然後透過進度訊息向用戶顯示。

範圍是永久性的。 支援的操作為 [取得]。

EnrollmentStatusTracking/Setup/Apps 必填。 用戶內容和裝置內容都支援此節點。 提供設定，以與 ESP 通訊它應該封鎖的應用程式安裝，並將狀態消息中的進度提供給使用者。

範圍是永久性的。 支援的操作為 [取得]。

EnrollmentStatusTracking/Setup/Apps/PolicyProviders 必填。 用戶內容和裝置內容都支援此節點。 指定此 CSP 的應用程式原則提供者。 這些是 ESP 在向用戶顯示具有狀態的追蹤訊息之前應該等候的原則提供者。

範圍是永久性的。 支援的操作為 [取得]。

EnrollmentStatusTracking/Setup/Apps/PolicyProviders/ProviderName 選。 用戶內容和裝置內容都支援此節點。 表示 ESP 的應用程式原則提供者。 此節點的存在向 ESP 指出，在 TrackingPoliciesCreated 節點設定為 true 之前，它不應該顯示追蹤狀態消息。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

EnrollmentStatusTracking/Setup/Apps/PolicyProviders/ProviderName/TrackingPoliciesCreated 必填。 用戶內容和裝置內容都支援此節點。 指出提供者是否已建立追蹤應用程式安裝進度所需的 ESP 原則。 原則提供者本身必須設定此節點的值，而不是 MDM 伺服器。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

實值類型為布爾值。 預期的值如下：

  • true— 表示提供者已建立必要的原則。
  • false— 指出提供者尚未建立必要的原則。 這是預設值。

EnrollmentStatusTracking/Setup/Apps/Tracking 必填。 用戶內容和裝置內容都支援此節點。 ESP 正在追蹤之應用程式安裝的根節點。

範圍是永久性的。 支援的操作為 [取得]。

EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName 選。 用戶內容和裝置內容都支援此節點。 指出負責安裝應用程式並將狀態提供給ESP的提供者名稱。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName 選擇性。 用戶內容和裝置內容都支援此節點。 代表APP的唯一名稱，此應用程式的進度應該由ESP追蹤。 原則提供者可以定義任何任意應用程式名稱，因為 ESP 不會直接使用應用程式名稱。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName/InstallationState 選擇性。 用戶內容和裝置內容都支援此節點。 表示應用程式的安裝狀態。 原則提供者 (不是 MDM 伺服器) 必須更新此節點，ESP 才能追蹤安裝進度並更新狀態消息。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

值類型為整數。 預期的值如下：

  • 1— NotInstalled
  • 2— InProgress
  • 3— 已完成
  • 4— 錯誤

EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName/RebootRequired 選擇性。 用戶內容和裝置內容都支援此節點。 指出應用程式安裝是否需要 ESP 發出重新啟動。 安裝應用程式的原則提供者 (不是 MDM 伺服器) 必須設定此節點。 如果原則提供者未設定此節點，ESP 將不會重新啟動裝置以進行應用程式安裝。

範圍是動態的。 支持的作業包括 Get、Add、Delete 和 Replace。

值類型為整數。 預期的值如下：

  • 1— NotRequired
  • 2— SoftReboot
  • 3— HardReboot

EnrollmentStatusTracking/Setup/HasProvisioningCompleted 必填。 用戶內容和裝置內容都支援此節點。 ESP 會在完成時設定此節點。 提供者可以查詢此節點來判斷 ESP 是否顯示，這可讓他們判斷是否仍需要透過此 CSP 提供 ESP 的狀態更新。

範圍是永久性的。 支援的操作為 [取得]。

實值類型為布爾值。 預期的值如下：

  • true— 表示 ESP 已完成。 這是預設值。
  • false— 指出 ESP 已顯示，且布建仍在進行中。

設定服務提供者參考