EnrollmentStatusTracking 云解决方案提供商EnrollmentStatusTracking CSP

在 Autopilot 部署期间,你可以将注册状态页 (ESP) ,以阻止设备使用,直到安装所需的应用。During Autopilot deployment, you can configure the Enrollment Status Page (ESP) to block the device use until the required apps are installed. 可以选择在使用设备之前必须安装的应用。You can select the apps that must be installed before using the device. EnrollmentStatusTracking 配置服务提供程序 (CSP) 由 Intune 的代理(如 SideCar)用于配置 ESP 以阻止设备使用,直到安装必需的 Win32 应用。The EnrollmentStatusTracking configuration service provider (CSP) is used by Intune's agents, such as SideCar to configure ESP for blocking the device use until the required Win32 apps are installed. 它跟踪所需策略提供程序的安装状态及其安装的应用并将其发送到 ESP,这向用户显示安装进度消息。It tracks the installation status of the required policy providers and the apps they install and sends it to ESP, which displays the installation progress message to the user. 有关 ESP 详细信息,请参阅 Windows Autopilot 注册状态页For more information on ESP, see Windows Autopilot Enrollment Status page.

ESP 使用 EnrollmentStatusTracking CSP 和 DMClient CSP 跟踪不同应用的安装。ESP uses the EnrollmentStatusTracking CSP along with the DMClient CSP to track the installation of different apps. EnrollmentStatusTracking CSP 跟踪 Win32 应用安装,DMClient CSP 跟踪 MSI 和通用 Windows 平台应用安装。The EnrollmentStatusTracking CSP tracks Win32 apps installations and DMClient CSP tracks MSI and Universal Windows Platform apps installations. 在 DMClient CSP 中 ,FirstSyncStatus/ExpectedMSIAppPackagesFirstSyncStatus/ExpectedModernAppPackages 节点列出了要跟踪其安装的应用。In DMClient CSP, the FirstSyncStatus/ExpectedMSIAppPackages and FirstSyncStatus/ExpectedModernAppPackages nodes list the apps to track their installation. 有关详细信息,请参阅 DMClient CSP。See DMClient CSP for more information.

EnrollmentStatusTracking CSP 已添加到 Windows 10 版本 1903 中。The EnrollmentStatusTracking CSP was added in Windows 10, version 1903.

下面以树格式显示 EnrollmentStatusTracking CSP。The following shows the EnrollmentStatusTracking CSP in tree format.

./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


./User/Vendor/MSFT
./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./Vendor/MSFT
对于设备上下文,请使用 ./Device/Vendor/MSFT 路径,对于用户上下文,请使用 ./User/Vendor/MSFT 路径。For device context, use ./Device/Vendor/MSFT path and for user context, use ./User/Vendor/MSFT path.

EnrollmentStatusTrackingEnrollmentStatusTracking
必需。Required. CSP 的根节点。Root node for the CSP. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
提供用于传达 ESP 必须阻止的策略的设置。Provides the settings to communicate what policies the ESP must block on. 通过使用这些设置,策略提供程序将自行注册和必须跟踪的策略集。Using these settings, policy providers register themselves and the set of policies that must be tracked. ESP 在向用户显示的状态消息中包含这些策略设置计数。The ESP includes the counts of these policy settings in the status message that is displayed to the user. 它还阻止 ESP,直到预配所有策略。It also blocks ESP until all the policies are provisioned. 策略提供程序应该通过更新相应的节点值来驱动状态更新,这些值随后会反映在 ESP 状态消息中。The policy provider is expected to drive the status updates by updating the appropriate node values, which are then reflected in the ESP status message.

作用域是永久性的。Scope is permanent. 支持的操作为 Get。Supported operation is Get.

EnrollmentStatusTracking/DevicePreparationEnrollmentStatusTracking/DevicePreparation
必需。Required. 此节点仅在设备上下文中受支持。This node is supported only in device context.
指定 ESP 在设备准备阶段读取的设置。Specifies the settings that ESP reads during the device preparation phase. 这些设置用于在 ESP 的设备设置阶段预配设备之前安排任何设置活动。These settings are used to orchestrate any setup activities prior to provisioning the device in the device setup phase of the ESP.

作用域是永久性的。Scope is permanent. 支持的操作为 Get。Supported operation is Get.

EnrollmentStatusTracking/DevicePreparation/PolicyProvidersEnrollmentStatusTracking/DevicePreparation/PolicyProviders
必需。Required. 此节点仅在设备上下文中受支持。This node is supported only in device context.
向 ESP 指示,它应在设备准备阶段等待,直到所有策略提供程序的 InstallationState 节点都设置为 2 (NotRequired) 或 3 (Completed) 。Indicates to the ESP that it should wait in the device preparation phase until all the policy providers have their InstallationState node set as 2 (NotRequired) or 3 (Completed).

作用域是永久性的。Scope is permanent. 支持的操作为 Get。Supported operation is Get.

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderNameEnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName
可选。Optional. 此节点仅在设备上下文中受支持。This node is supported only in device context.
表示 ESP 的策略提供程序。Represents a policy provider for the ESP. 应该为节点指定策略提供程序的唯一名称。The node should be given a unique name for the policy provider. 注册策略提供程序向 ESP 指示,在提供程序将 InstallationState 节点设置为 2 (NotRequired) 或 3 (Completed) 之前,它应在设备准备阶段进行阻止。Registration of a policy provider indicates to ESP that it should block in the device preparation phase until the provider sets its InstallationState node to 2 (NotRequired) or 3 (Completed). 所有注册的策略提供程序都标记为"已完成"或"NotRequired"后,ESP 将进入设备设置阶段。Once all the registered policy providers are marked as Completed or NotRequired, the ESP progresses to the device setup phase.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/InstallationStateEnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/InstallationState
必需。Required. 此节点仅在设备上下文中受支持。This node is supported only in device context.
将策略提供程序安装状态传递回 ESP。Communicates the policy provider installation state back to ESP.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

值类型为整数。Value type is integer. 预期值如下所示:Expected values are as follows:

  • 1 — NotInstalled1 — NotInstalled
  • 2 — NotRequired2 — NotRequired
  • 3 — 已完成3 — Completed
  • 4 — 错误4 — Error

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/LastErrorEnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/LastError
必需。Required. 此节点仅在设备上下文中受支持。This node is supported only in device context.
表示应用程序安装过程中的最后一个错误代码。Represents the last error code during the application installation process. 如果策略提供程序无法安装,它可以选择设置 HRESULT 错误代码,ESP 可以在向用户显示的错误消息中显示该代码。If a policy provider fails to install, it can optionally set an HRESULT error code that the ESP can display in an error message to the user. ESP 仅在提供程序的 InstallationState 节点设置为 4 时读取此节点 (错误) 。ESP reads this node only when the provider's InstallationState node is set to 4 (Error). 此节点必须由策略提供程序设置,而不是由 MDM 服务器设置。This node must be set only by the policy provider, and not by the MDM server.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

值类型为整数。Value type is integer.

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/TimeoutEnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/Timeout
可选。Optional. 此节点仅在设备上下文中受支持。This node is supported only in device context.
表示提供程序安装过程在 ESP 显示错误之前可以运行的时间(分钟)。Represents the amount of time, in minutes, that the provider installation process can run before the ESP shows an error. 提供程序安装在 InstallationState 节点设置为 2 (NotRequired 或 3) 3 (Completed) 。Provider installation is complete when the InstallationState node is set to 2 (NotRequired) or 3 (Completed). 如果未指定超时值,ESP 将选择默认超时值 15 分钟。If no timeout value is specified, ESP selects the default timeout value of 15 minutes.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

值类型为整数。Value type is integer. 默认值为 15 分钟。The default is 15 minutes.

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/TrackedResourceTypesEnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/TrackedResourceTypes
必需。Required. 此节点仅在设备上下文中受支持。This node is supported only in device context.
此节点的子级注册策略提供程序支持预配的资源类型。This node's children register which resource types the policy provider supports for provisioning. 只有特定资源类型的注册提供商才能将策略与 ESP 跟踪邮件合并。Only registered providers for a particular resource type will have their policies incorporated with ESP tracking message.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/TrackedResourceTypes/AppsEnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/TrackedResourceTypes/Apps
必需。Required. 此节点仅在设备上下文中受支持。This node is supported only in device context.
此节点指定策略提供程序是否注册应用预配。This node specifies if the policy provider is registered for app provisioning.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

值类型为 boolean。Value type is boolean. 预期值如下所示:Expected values are as follows:

  • false — 指示策略提供程序未注册应用预配。false — Indicates that the policy provider is not registered for app provisioning. 这是默认设置。This is the default.
  • true — 指示策略提供程序已注册应用预配。true — Indicates that the policy provider is registered for app provisioning.

EnrollmentStatusTracking/SetupEnrollmentStatusTracking/Setup
必需。Required. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
提供 ESP 在设备上下文中的用户上下文和设备设置阶段的帐户设置阶段读取的设置。Provides the settings that ESP reads during the account setup phase in the user context and device setup phase in the device context. 策略提供程序使用此节点将进度状态传达回 ESP,然后通过进度消息向用户显示进度状态。Policy providers use this node to communicate progress status back to the ESP, which is then displayed to the user through progress messages.

作用域是永久性的。Scope is permanent. 支持的操作为 Get。Supported operation is Get.

EnrollmentStatusTracking/Setup/AppsEnrollmentStatusTracking/Setup/Apps
必需。Required. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
提供设置以与 ESP 通信,它应阻止哪些应用安装,并为用户提供状态消息中的进度。Provides the settings to communicate to the ESP which app installations it should block on and provide progress in the status message to the user.

作用域是永久性的。Scope is permanent. 支持的操作为 Get。Supported operation is Get.

EnrollmentStatusTracking/Setup/Apps/PolicyProvidersEnrollmentStatusTracking/Setup/Apps/PolicyProviders
必需。Required. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
为此 CSP 指定应用策略提供程序。Specifies the app policy providers for this CSP. 这些是 ESP 应等待的策略提供程序,然后向用户显示状态为跟踪邮件。These are the policy providers the ESP should wait on before showing the tracking message with the status to the user.

作用域是永久性的。Scope is permanent. 支持的操作为 Get。Supported operation is Get.

EnrollmentStatusTracking/Setup/Apps/PolicyProviders /** ProviderName**EnrollmentStatusTracking/Setup/Apps/PolicyProviders/ProviderName
可选。Optional. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
表示 ESP 的应用策略提供程序。Represents an app policy provider for the ESP. 此节点的存在向 ESP 指示,在 TrackingPoliciesCreated 节点设置为 true 之前,不应显示跟踪状态消息。Existence of this node indicates to the ESP that it should not show the tracking status message until the TrackingPoliciesCreated node has been set to true.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

EnrollmentStatusTracking/Setup/Apps/PolicyProviders/ProviderName/TrackingPoliciesCreatedEnrollmentStatusTracking/Setup/Apps/PolicyProviders/ProviderName/TrackingPoliciesCreated
必需。Required. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
指示提供程序是否创建了 ESP 所需的策略以用于跟踪应用安装进度。Indicates if the provider has created the required policies for the ESP to use for tracking app installation progress. 策略提供程序本身应设置此节点的值,而不是 MDM 服务器的值。The policy provider itself is expected to set the value of this node, not the MDM server.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

值类型为 boolean。Value type is boolean. 预期值如下所示:The expected values are as follows:

  • true — 指示提供程序已创建所需策略。true — Indicates that the provider has created the required policies.
  • false — 指示提供程序尚未创建所需策略。false — Indicates that the provider has not created the required policies. 这是默认设置。This is the default.

EnrollmentStatusTracking/Setup/Apps/TrackingEnrollmentStatusTracking/Setup/Apps/Tracking
必需。Required. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
ESP 跟踪的应用安装的根节点。Root node for the app installations being tracked by the ESP.

作用域是永久性的。Scope is permanent. 支持的操作为 Get。Supported operation is Get.

EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderNameEnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName
可选。Optional. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
指示负责安装应用和向 ESP 提供状态的提供程序名称。Indicates the provider name responsible for installing the apps and providing status back to ESP.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName / AppNameEnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName
可选。Optional. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
表示应用的唯一名称,其进度应由 ESP 进行跟踪。Represents a unique name for the app whose progress should be tracked by the ESP. 策略提供程序可以定义任何任意应用名称,因为 ESP 不会直接使用应用名称。The policy provider can define any arbitrary app name as ESP does not use the app name directly.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName / AppName/InstallationStateEnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName/InstallationState
可选。Optional. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
表示应用的安装状态。Represents the installation state for the app. 不是 MDM (策略) 必须更新 ESP 的此节点,以跟踪安装进度并更新状态消息。The policy providers (not the MDM server) must update this node for the ESP to track the installation progress and update the status message.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

值类型为整数。Value type is integer. 预期值如下所示:Expected values are as follows:

  • 1 — NotInstalled1 — NotInstalled
  • 2 — InProgress2 — InProgress
  • 3 — 已完成3 — Completed
  • 4 — 错误4 — Error

EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName / AppName/RebootRequiredEnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName/RebootRequired
可选。Optional. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
指示应用安装是否要求 ESP 发出重新启动。Indicates if the app installation requires ESP to issue a reboot. 安装应用的策略提供程序 (MDM 服务器) 必须设置此节点。The policy providers installing the app (not the MDM server) must set this node. 如果策略提供程序未设置此节点,ESP 将不会重新启动设备以安装应用。If the policy providers do not set this node, the ESP will not reboot the device for the app installation.

范围是动态的。Scope is dynamic. 支持的操作包括 Get、Add、Delete 和 Replace。Supported operations are Get, Add, Delete, and Replace.

值类型为整数。Value type is integer. 预期值如下所示:Expected values are as follows:

  • 1 — NotRequired1 — NotRequired
  • 2 — SoftReboot2 — SoftReboot
  • 3 — HardReboot3 — HardReboot

EnrollmentStatusTracking/Setup/HasProvisioningCompletedEnrollmentStatusTracking/Setup/HasProvisioningCompleted
必需。Required. 此节点在用户上下文和设备上下文中均受支持。This node is supported in both user context and device context.
ESP 在完成后设置此节点。ESP sets this node when it completes. 提供程序可以查询此节点以确定 ESP 是否显示,这允许他们确定是否仍然需要通过此 CSP 为 ESP 提供状态更新。Providers can query this node to determine if the ESP is showing, which allows them to determine if they still need to provide status updates for the ESP through this CSP.

作用域是永久性的。Scope is permanent. 支持的操作为 Get。Supported operation is Get.

值类型为 boolean。Value type is boolean. 预期值如下所示:Expected values are as follows:

  • true — 指示 ESP 已完成。true — Indicates that ESP has completed. 这是默认设置。This is the default.
  • false — 指示显示 ESP,并且预配仍在进行。false — Indicates that ESP is displayed, and provisioning is still going.