EnrollmentStatusTracking 云解决方案提供商
下表显示了 Windows 的适用性:
版次 | Windows 10 | Windows 11 |
---|---|---|
Home 键 | 是 | 是 |
专业版 | 是 | 是 |
Windows SE | 否 | 是 |
商用版 | 是 | 是 |
企业 | 是 | 是 |
教育 | 是 | 是 |
在 Autopilot 部署期间,可以将注册状态页 (ESP) 配置为阻止设备使用,直到安装所需的应用。 可以选择在使用设备之前必须安装的应用。 Intune的代理(如 SideCar)使用 EnrollmentStatusTracking 配置服务提供程序 (CSP) 来配置 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。
Windows 10版本 1903 中添加了 EnrollmentStatusTracking CSP。
下面显示了树格式的 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 状态消息中。
范围是永久性的。 支持的操作为 Get。
EnrollmentStatusTracking/DevicePreparation 必填。 仅在设备上下文中支持此节点。 指定 ESP 在设备准备阶段读取的设置。 在 ESP 的设备设置阶段预配设备之前,这些设置用于协调任何安装活动。
范围是永久性的。 支持的操作为 Get。
EnrollmentStatusTracking/DevicePreparation/PolicyProviders 必填。 仅在设备上下文中支持此节点。 向 ESP 指示应在设备准备阶段等待,直到所有策略提供程序将其 InstallationState 节点设置为 2 (NotRequired) 或 3 (Completed) 。
范围是永久性的。 支持的操作为 Get。
EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName 选。 仅在设备上下文中支持此节点。 表示 ESP 的策略提供程序。 应为节点提供策略提供程序的唯一名称。 策略提供程序的注册向 ESP 指示应在设备准备阶段阻止,直到提供程序将其 InstallationState 节点设置为 2 (NotRequired) 或 3 (Completed) 。 将所有已注册的策略提供程序标记为“已完成”或“未获得”后,ESP 将进入设备设置阶段。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/InstallationState 必填。 仅在设备上下文中支持此节点。 将策略提供程序安装状态传回 ESP。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
值类型为整数。 预期值如下所示:
- 1 — 未安装
- 2 - NotRequired
- 3 - 已完成
- 4 - 错误
EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/LastError 必填。 仅在设备上下文中支持此节点。 表示应用程序安装过程中的最后一个错误代码。 如果策略提供程序安装失败,它可以选择性地设置 HRESULT 错误代码,ESP 可在向用户的错误消息中显示该代码。 仅当提供程序的 InstallationState 节点设置为 4 (错误) 时,ESP 才会读取此节点。 此节点只能由策略提供程序设置,而不能由 MDM 服务器设置。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
值类型为整数。
EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/Timeout 选。 仅在设备上下文中支持此节点。 表示在 ESP 显示错误之前提供程序安装过程可以运行的时间量(以分钟为单位)。 当 InstallationState 节点设置为 2 (NotRequired) 或 3 (Completed) 时,提供程序安装完成。 如果未指定超时值,ESP 将选择默认超时值 15 分钟。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
值类型为整数。 默认值为 15 分钟。
EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/TrackedResourceTypes 必填。 仅在设备上下文中支持此节点。 此节点的子节点注册策略提供程序支持预配的资源类型。 只有特定资源类型的已注册提供程序才会将其策略与 ESP 跟踪消息合并。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName/TrackedResourceTypes/Apps 必填。 仅在设备上下文中支持此节点。 此节点指定是否为应用预配注册了策略提供程序。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
值类型为布尔值。 预期值如下所示:
- false - 指示未为应用预配注册策略提供程序。 这是默认设置。
- true - 指示策略提供程序已注册应用预配。
EnrollmentStatusTracking/Setup 必填。 此节点在用户上下文和设备上下文中均受支持。 提供 ESP 在用户上下文中的帐户设置阶段和设备设置阶段读取的设置。 策略提供程序使用此节点将进度状态传回 ESP,然后通过进度消息显示给用户。
范围是永久性的。 支持的操作为 Get。
EnrollmentStatusTracking/Setup/Apps 必填。 此节点在用户上下文和设备上下文中均受支持。 提供设置,以便与 ESP 通信它应阻止哪个应用安装,并在状态消息中向用户提供进度。
范围是永久性的。 支持的操作为 Get。
EnrollmentStatusTracking/Setup/Apps/PolicyProviders 必填。 此节点在用户上下文和设备上下文中均受支持。 指定此 CSP 的应用策略提供程序。 这些是 ESP 在向用户显示状态跟踪消息之前应等待的策略提供程序。
范围是永久性的。 支持的操作为 Get。
EnrollmentStatusTracking/Setup/Apps/PolicyProviders/ProviderName 选。 此节点在用户上下文和设备上下文中均受支持。 表示 ESP 的应用策略提供程序。 此节点的存在向 ESP 表明,在 TrackingPoliciesCreated 节点设置为 true 之前,它不应显示跟踪状态消息。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
EnrollmentStatusTracking/Setup/Apps/PolicyProviders/ProviderName/TrackingPoliciesCreated 必填。 此节点在用户上下文和设备上下文中均受支持。 指示提供程序是否已为 ESP 创建了用于跟踪应用安装进度所需的策略。 策略提供程序本身应设置此节点的值,而不是 MDM 服务器的值。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
值类型为布尔值。 预期值如下所示:
- true - 指示提供程序已创建所需的策略。
- false - 指示提供程序尚未创建所需的策略。 这是默认设置。
EnrollmentStatusTracking/Setup/Apps/Tracking 必填。 此节点在用户上下文和设备上下文中均受支持。 ESP 正在跟踪的应用安装的根节点。
范围是永久性的。 支持的操作为 Get。
EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName 选。 此节点在用户上下文和设备上下文中均受支持。 指示负责安装应用并将状态提供回 ESP 的提供程序名称。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName 可选。 此节点在用户上下文和设备上下文中均受支持。 表示 ESP 应跟踪其进度的应用的唯一名称。 策略提供程序可以定义任何任意应用名称,因为 ESP 不直接使用该应用名称。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName/InstallationState 可选。 此节点在用户上下文和设备上下文中均受支持。 表示应用的安装状态。 策略提供程序 (而不是 MDM 服务器) 必须更新此节点,以便 ESP 跟踪安装进度并更新状态消息。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
值类型为整数。 预期值如下所示:
- 1 — 未安装
- 2 - InProgress
- 3 - 已完成
- 4 - 错误
EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName/RebootRequired 可选。 此节点在用户上下文和设备上下文中均受支持。 指示应用安装是否需要 ESP 来发出重新启动。 安装应用 (而不是 MDM 服务器) 的策略提供程序必须设置此节点。 如果策略提供程序未设置此节点,则 ESP 不会重启设备以安装应用。
范围是动态的。 支持的操作包括“获取”、“添加”、“删除”和“替换”。
值类型为整数。 预期值如下所示:
- 1 - NotRequired
- 2 - SoftReboot
- 3 - HardReboot
EnrollmentStatusTracking/Setup/HasProvisioningCompleted 必填。 此节点在用户上下文和设备上下文中均受支持。 ESP 在完成时设置此节点。 提供程序可以查询此节点以确定 ESP 是否正在显示,这允许他们确定是否仍需要通过此 CSP 为 ESP 提供状态更新。
范围是永久性的。 支持的操作为 Get。
值类型为布尔值。 预期值如下所示:
- true - 指示 ESP 已完成。 这是默认设置。
- false - 指示 ESP 已显示,并且预配仍在进行。