EnrollmentStatusTracking CSP
次の表は、Windows の適用性を示しています。
| エディション | Windows 10 | Windows 11 |
|---|---|---|
| ホーム | はい | はい |
| Pro | はい | はい |
| Windows SE | いいえ | はい |
| Business | はい | はい |
| Enterprise | はい | はい |
| Education | はい | ○ |
Autopilot の展開中に、必要なアプリがインストールされるまでデバイスの使用をブロックするように登録状態ページ (ESP) を構成できます。 デバイスを使用する前にインストールする必要があるアプリを選択できます。 EnrollmentStatusTracking 構成サービス プロバイダー (CSP) は、必要な Win32 アプリがインストールされるまでデバイスの使用をブロックするために ESP を構成するために、SideCar などのIntuneのエージェントによって使用されます。 必要なポリシー プロバイダーとインストールするアプリのインストール状態を追跡し、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 は、バージョン 1903 Windows 10に追加されました。
次に、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 必須。 このノードは、デバイス コンテキストでのみサポートされます。 すべてのポリシー プロバイダーが InstallationState ノードを 2 (NotRequired) または 3 (Completed) に設定するまで、デバイス準備フェーズで待機する必要があることを ESP に示します。
スコープは永続的です。 サポートされている操作は Get です。
EnrollmentStatusTracking/DevicePreparation/PolicyProviders/ProviderName オプション。 このノードは、デバイス コンテキストでのみサポートされます。 ESP のポリシー プロバイダーを表します。 ノードには、ポリシー プロバイダーの一意の名前を指定する必要があります。 ポリシー プロバイダーの登録は、プロバイダーが InstallationState ノードを 2 (NotRequired) または 3 (Completed) に設定するまで、デバイス準備フェーズでブロックする必要があることを ESP に示します。 登録されているすべてのポリシー プロバイダーが完了または NotRequired としてマークされると、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 エラー コードを設定できます。 ESP は、プロバイダーの InstallationState ノードが 4 (エラー) に設定されている場合にのみ、このノードを読み取ります。 このノードは、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 に伝え、進行状況メッセージを介してユーザーに表示されます。
スコープは永続的です。 サポートされている操作は Get です。
EnrollmentStatusTracking/Setup/Apps 必須。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 ブロックする必要があるアプリのインストールを ESP に通信するための設定を提供し、ステータス メッセージの進行状況をユーザーに提供します。
スコープは永続的です。 サポートされている操作は Get です。
EnrollmentStatusTracking/Setup/Apps/PolicyProviders 必須。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 この CSP のアプリ ポリシー プロバイダーを指定します。 これらは、ESP がユーザーに状態を示す追跡メッセージを表示する前に待機するポリシー プロバイダーです。
スコープは永続的です。 サポートされている操作は Get です。
EnrollmentStatusTracking/Setup/Apps/PolicyProviders/ProviderName オプション。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 ESP のアプリ ポリシー プロバイダーを表します。 このノードの存在は、TrackingPoliciesCreated ノードが true に設定されるまで追跡状態メッセージを表示しないことを ESP に示します。
スコープは動的です。 サポートされている操作は、Get、Add、Delete、Replace です。
EnrollmentStatusTracking/Setup/Apps/PolicyProviders/ProviderName/TrackingPoliciesCreated 必須。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 プロバイダーが、アプリのインストールの進行状況を追跡するために使用する ESP に必要なポリシーを作成したかどうかを示します。 ポリシー プロバイダー自体は、MDM サーバーではなく、このノードの値を設定する必要があります。
スコープは動的です。 サポートされている操作は、Get、Add、Delete、Replace です。
値の型はブール値です。 想定される値は次のとおりです。
- true — プロバイダーが必要なポリシーを作成したことを示します。
- false — プロバイダーが必要なポリシーを作成していないことを示します。 これが既定値です。
EnrollmentStatusTracking/Setup/Apps/Tracking 必須。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 ESP によって追跡されているアプリのインストールのルート ノード。
スコープは永続的です。 サポートされている操作は Get です。
EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName オプション。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 アプリをインストールし、状態を ESP に戻す役割を担うプロバイダー名を示します。
スコープは動的です。 サポートされている操作は、Get、Add、Delete、Replace です。
EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName 省略可能。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 ESP によって進行状況を追跡する必要があるアプリの一意の名前を表します。 ESP ではアプリ名が直接使用されないため、ポリシー プロバイダーは任意のアプリ名を定義できます。
スコープは動的です。 サポートされている操作は、Get、Add、Delete、Replace です。
EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName/InstallationState 省略可能。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 アプリのインストール状態を表します。 ポリシー プロバイダー (MDM サーバーではない) は、ESP でインストールの進行状況を追跡し、ステータス メッセージを更新するために、このノードを更新する必要があります。
スコープは動的です。 サポートされている操作は、Get、Add、Delete、Replace です。
値の種類は整数です。 想定される値は次のとおりです。
- 1 - NotInstalled
- 2 - InProgresss
- 3 - 完了
- 4 - エラー
EnrollmentStatusTracking/Setup/Apps/Tracking/ProviderName/AppName/RebootRequired Optional。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 アプリのインストールで ESP が再起動を発行する必要があるかどうかを示します。 (MDM サーバーではなく) アプリをインストールするポリシー プロバイダーは、このノードを設定する必要があります。 ポリシー プロバイダーがこのノードを設定していない場合、ESP はアプリのインストール用にデバイスを再起動しません。
スコープは動的です。 サポートされている操作は、Get、Add、Delete、Replace です。
値の種類は整数です。 想定される値は次のとおりです。
- 1 - NotRequired
- 2 - SoftReboot
- 3 - HardReboot
EnrollmentStatusTracking/Setup/HasProvisioningCompleted 必須。 このノードは、ユーザー コンテキストとデバイス コンテキストの両方でサポートされています。 ESP は、完了時にこのノードを設定します。 プロバイダーは、このノードにクエリを実行して ESP が表示されているかどうかを判断できます。これにより、この CSP を介して ESP の状態更新プログラムを提供する必要があるかどうかを判断できます。
スコープは永続的です。 サポートされている操作は Get です。
値の型はブール値です。 想定される値は次のとおりです。
- true — ESP が完了したことを示します。 これが既定値です。
- false : ESP が表示され、プロビジョニングがまだ進行中であることを示します。
関連トピック
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示