原則實體的參考

原則 類別包含 用於行動裝置的實體,可追蹤以下資訊:

  • 裝置組態設定檔、應用程式組態設定檔和合規性原則的庫存
  • 每天處於成功、擱置中、失敗或錯誤狀態的裝置數量
  • 每天處於成功、擱置中、失敗或錯誤狀態的使用者數目
  • 處於成功、擱置中、失敗或錯誤狀態的裝置累計數目

原則

原則實體會列出裝置組態設定檔、應用程式組態設定檔和合規性原則。 您可以使用 Mobile 裝置管理 (MDM) 將原則指派給企業中的群組。

屬性 描述 範例
policyKey 代表資料倉儲中原則的唯一金鑰。 123
policyId 資料倉儲中原則的唯一識別碼。 B66BC706-FFFF-7437-0340-032819502773
policyName 原則的名稱。 「Windows 10 基準」
policyVersion 原則的版本。 編輯或變更原則時,會建立較新的版本。 1, 2, 3
isDeleted 指出原則記錄是否已更新。
True- 原則有新記錄且欄位已更新。
False- 原則的最新記錄。
True/False
startDateInclusiveUTC 在資料倉儲中建立原則時的 UTC 日期和時間。 2016 年 11 月 23 日上午 12:00:00
deletedDateUTC IsDeleted 變更為 True 時的 UTC 日期和時間。 2016 年 11 月 23 日上午 12:00:00
rowLastModifiedDateTimeUTC 上次在資料倉儲中修改原則時的 UTC 日期和時間。 2016 年 11 月 23 日上午 12:00:00

policyTypes

policyType 實體會列出裝置組態設定檔、應用程式組態設定檔和合規性原則的類型。 您可以使用 Mobile 裝置管理 (MDM) 將原則指派給企業中的群組。

屬性 描述 範例
policyTypeId 來源系統中原則的唯一識別碼。 123
policyTypeKey 資料倉儲中原則的唯一識別碼。 1
policyTypeName 原則類型的名稱。 Windows 10 合規性原則。

裝置設定

deviceConfigurationProfileDeviceActivity 實體會列出每天處於成功、擱置中、失敗或錯誤狀態的裝置數目。 此數字反映指派給實體的裝置組態設定檔。 例如,如果 裝置 其所有指派的原則都處於成功狀態,它會在當天將成功計數器遞增 1。 如果裝置有兩個設定檔指派給它,一個處於成功狀態,另一個處於錯誤狀態,實體會遞增 Succeeded 計數器,並將裝置置於錯誤狀態。 該實體會列出過去 30 天內給定日期有多少裝置處於哪種狀態。

屬性 描述 範例
dateKey 在資料倉儲中記錄裝置組態設定檔簽入時的日期機碼。 20160703
擱置中 處於擱置狀態的唯一裝置數目。 123
成功 處於成功狀態的唯一裝置數目。 12
錯誤 處於錯誤狀態的唯一裝置數目。 10
失敗 處於失敗狀態的唯一裝置數目。 2

deviceConfigurationProfileUserActivity 實體會列出每天處於成功、擱置中、失敗或錯誤狀態的使用者數目。 此數字反映指派給實體的裝置組態設定檔。 例如,如果使用者其所有指派的原則都處於成功狀態,則該 使用者 會在當天將成功計數器向上移動 1。 如果使用者有兩個設定檔指派給他們,一個處於成功狀態,另一個處於錯誤狀態,則會計算處於錯誤狀態的使用者。 deviceConfigurationProfileUserActivity 實體會列出過去 30 天內,有多少使用者在某一天處於哪種狀態。

屬性 描述 範例
dateKey 在資料倉儲中記錄裝置組態設定檔簽入時的日期機碼。 20160703
擱置中 處於擱置中狀態的唯一使用者數目。 123
成功 處於成功狀態的唯一使用者數目。 12
錯誤 處於錯誤狀態的唯一使用者數目。 10
失敗 處於失敗狀態的唯一使用者數目。 2

policyTypeActivities

policyTypeActivity 實體會列出處於成功、擱置中、失敗或錯誤狀態的裝置累計數目。 它會列出這些與裝置組態設定檔、應用程式組態設定檔或合規性原則相關的每日狀態。

屬性 描述 範例
dateKey 在資料倉儲中記錄裝置組態設定檔簽入時的 dateKey。 20160703
policyKey policyKey 可以與 policy 聯結以取得 policyName。 Windows 10 基準
policyTypeKey 原則金鑰類型,可以與原則類型聯結,以取得原則類型名稱。 Windows10 合規性原則
擱置中 處於擱置狀態的唯一裝置數目。 123
成功 處於成功狀態的唯一裝置數目。 12
錯誤 處於錯誤狀態的唯一裝置數目。 10
失敗 處於失敗狀態的唯一裝置數目。 2

合規性原則

合規性原則 API 參考包含提供指派給裝置合規性原則的狀態資訊的實體。

compliancePolicyStatusDeviceActivities

下表摘要說明合規性原則指派給裝置的狀態。 它會列出在每個合規性狀態中找到的裝置計數。

屬性 描述 範例
dateKey 為合規性原則建立摘要時的 Date 機碼。 20161204
未知 離線或因為其他原因而無法與 Intune 或 Microsoft Entra ID 通訊的裝置數目。 5
不適用 系統管理員所針對的裝置合規性原則不適用的裝置數目。 201
符合規範 成功套用系統管理員所設定的一或多個裝置合規性原則的裝置數目。 4083
inGracePeriod 不符合規範但在系統管理員定義的寬限期內的裝置數目。 57
不合規 未能套用系統管理員所針對的一或多個裝置合規性原則,或使用者未遵循系統管理員所針對的原則的裝置數目。 43
錯誤 無法與 Intune 或 Microsoft Entra ID 通訊並傳回錯誤訊息的裝置數目。 3

compliancePolicyStatusDevicePerPolicyActivities

下表摘要說明根據每個原則和每個原則類型,對裝置的合規性原則指派狀態。 它會列出每個指派的合規性原則,在每種合規性狀態中找到的裝置計數。

屬性 描述 範例
dateKey 為合規性原則建立摘要時的 Date 機碼。 20161219
policyKey 建立摘要之合規性原則的索引鍵。 10178
policyPlatformKey 建立摘要之合規性原則的平台類型的索引鍵。 5
未知 離線或因為其他原因而無法與 Intune 或 Microsoft Entra ID 通訊的裝置數目。 13
不適用 系統管理員所針對的裝置合規性原則不適用的裝置數目。 3
符合規範 成功套用系統管理員所設定的一或多個裝置合規性原則的裝置數目。 45
inGracePeriod 不符合規範但在系統管理員定義的寬限期內的裝置數目。 3
不合規 未能套用系統管理員所針對的一或多個裝置合規性原則,或使用者未遵循系統管理員所針對的原則的裝置數目。 7
錯誤 無法與 Intune 或 Microsoft Entra ID 通訊並傳回錯誤訊息的裝置數目。 3

policyPlatformTypes

下表包含所有指派原則的平台類型。 原則:從未指派給任何裝置的平台類型不在此表格中。

屬性 描述 範例
policyPlatformTypeKey 原則平台類型的唯一金鑰。 20170519
policyPlatformTypeId 原則平台類型的唯一識別碼。 1
policyPlatformTypeName 原則平台類型的名稱。 AndroidForWork

policyDeviceActivities

下表列出每天處於成功、擱置中、失敗或錯誤狀態的裝置數。 此數字反映了每個原則類型設定檔的資料。 例如,如果裝置其所有指派的原則都處於成功狀態,它會在當天將成功計數器遞增 1。 如果裝置有兩個設定檔指派給它,一個處於成功狀態,另一個處於錯誤狀態,實體會遞增 Succeeded 計數器,並將裝置置於錯誤狀態。 policyDeviceActivity 實體會列出過去 30 天內,有多少裝置在某一天處於哪種狀態。

屬性 描述 範例
dateKey 在資料倉儲中記錄裝置組態設定檔簽入時的日期機碼。 20160703
擱置中 處於擱置狀態的唯一裝置數目。 123
成功 處於成功狀態的唯一裝置數目。 12
policyKey policyKey 可以與 policy 聯結以取得 policyName。 Windows 10 基準
錯誤 處於錯誤狀態的唯一裝置數目。 10
失敗 處於失敗狀態的唯一裝置數目。 2

policyUserActivities

下表列出每天處於成功、擱置中、失敗或錯誤狀態的使用者人數。 此數字反映了每個原則類型設定檔的資料。 例如,如果使用者其所有指派的原則都處於成功狀態,則該使用者會在當天將成功計數器向上移動 1。 如果使用者有兩個設定檔指派給他們,一個處於成功狀態,另一個處於錯誤狀態,則會計算處於錯誤狀態的使用者。 PolicyUserActivity 實體會列出過去 30 天內,有多少使用者在某一天處於哪個狀態。

屬性 描述 範例
dateKey 在資料倉儲中記錄裝置組態設定檔簽入時的日期機碼。 20160703
擱置中 處於擱置狀態的唯一裝置數目。 123
成功 處於成功狀態的唯一裝置數目。 12
policyKey policyKey 可以與 policy 聯結以取得 policyName。 Windows 10 基準
錯誤 處於錯誤狀態的唯一裝置數目。 10