Reference for Policy entities
The policies category contains entities for mobile devices that track information such as:
- Inventory of device configuration profiles, app configuration profiles, and compliance policies
- Number of devices in the succeeded, pending, failed, or error state per day
- Number of users in the succeeded, pending, failed, or error state per day
- Cumulative number of devices in the succeeded, pending, failed, or error state
policies
The policy entity lists device configuration profiles, app configuration profiles, and compliance policies. You can assign the policies with Mobile Device Management (MDM) to a group in your enterprise.
| Property | Description | Example |
|---|---|---|
| policyKey | Unique Key to represent the policy in the data warehouse. | 123 |
| policyId | Unique identifier of the Policy in the data warehouse. | b66bc706-ffff-7437-0340-032819502773 |
| policyName | Name of the Policy. | "Windows 10 Baseline" |
| policyVersion | Version of the Policy. When the policy is edited or changed, a newer version is created. | 1, 2, 3 |
| isDeleted | Indicates whether the Policy record has been updated. True- policy has a new record with updated fields. False- the latest record for the policy. |
True/False |
| startDateInclusiveUTC | Date and time in UTC when the policy was created in the data warehouse. | 11/23/2016 12:00:00 AM |
| deletedDateUTC | Date and time in UTC when IsDeleted changed to True. | 11/23/2016 12:00:00 AM |
| rowLastModifiedDateTimeUTC | Date and time in UTC when the policy was last modified in the data warehouse. | 11/23/2016 12:00:00 AM |
policyTypes
The policyType entity lists types of device configuration profiles, app configuration profiles, and Compliance policies. You can assign the policies with Mobile Device Management (MDM) to a group in your enterprise.
| Property | Description | Example |
|---|---|---|
| policyTypeId | Unique identifier of the policy in the source system. | 123 |
| policyTypeKey | Unique identifier of the policy in the data warehouse. | 1 |
| policyTypeName | Name of the policy type. | Windows 10 Compliance policy. |
Device Configuration
The deviceConfigurationProfileDeviceActivity entity lists the number of devices in the succeeded, pending, failed, or error state per day. The number reflects the Device configuration profiles assigned to the entity. For example, if a device is in the succeeded state for all its assigned policies, it increments the succeeded counter up one for that day. If a device has two profiles assigned to it, one in the succeeded state and another in an error state, the entity increments the Succeeded counter and place the device in the error state. The entity lists how many devices are in which state on a given day over the last 30 days.
| Property | Description | Example |
|---|---|---|
| dateKey | Date Key when the Device Configuration Profile check-in was recorded in the data warehouse. | 20160703 |
| pending | Number of unique Devices in pending state. | 123 |
| succeeded | Number of unique Devices in success state. | 12 |
| error | Number of unique Devices in error state. | 10 |
| failed | Number of unique Devices in failed state. | 2 |
The deviceConfigurationProfileUserActivity entity lists the number of users in the succeeded, pending, failed, or error state per day. The number reflects the Device configuration profiles assigned to the entity. For example, if a user is in the succeeded state for all their assigned policies, it moves up the succeeded counter by one for that day. If a user has two profiles assigned to them, one in the succeeded state and the other is in an error state, the user in the error state is counted. The deviceConfigurationProfileUserActivity entity lists how many users are in which state on a given day over the last 30 days.
| Property | Description | Example |
|---|---|---|
| dateKey | Date Key when the Device Configuration Profile check-in was recorded in the data warehouse. | 20160703 |
| pending | Number of unique Users in pending state. | 123 |
| succeeded | Number of unique Users in success state. | 12 |
| error | Number of unique Users in error state. | 10 |
| failed | Number of unique Users in failed state. | 2 |
policyTypeActivities
The policyTypeActivity entity lists the cumulative number of devices in the succeeded, pending, failed, or error state. It lists these states with respect to a device configuration profile, app configuration profile, or compliance policy per day.
| Property | Description | Example |
|---|---|---|
| dateKey | dateKey when the device Configuration profile check-in was recorded in the data warehouse. | 20160703 |
| policyKey | policyKey, can be joined with policy to get the policyName. | Windows 10 baseline |
| policyTypeKey | Type of Policy Key, can be joined with Policy Type to get the policy type name. | Windows10 Compliance Policy |
| pending | Number of unique devices in pending state. | 123 |
| succeeded | Number of unique devices in success state. | 12 |
| error | Number of unique devices in error state. | 10 |
| failed | Number of unique devices in failed state. | 2 |
Compliance Policy
The Compliance Policy API Reference contains entities that provide status information about compliance policies assigned to devices.
compliancePolicyStatusDeviceActivities
The following table summarizes the assignment status of compliance policies to devices. It lists the count of devices found in each compliance state.
| Property | Description | Example |
|---|---|---|
| dateKey | Date key when the summary was created for the compliance policy. | 20161204 |
| unknown | Number of devices that are offline or failed to communicate with Intune or Microsoft Entra ID for other reasons. | 5 |
| notApplicable | Number of devices where device compliance policies targeted by the admin are not applicable. | 201 |
| compliant | Number of devices that successfully applied one or more device compliance policies targeted by the admin. | 4083 |
| inGracePeriod | Number of devices that are not compliant but that are in the grace-period defined by the admin. | 57 |
| nonCompliant | Number of devices that failed to apply one or more device compliance policies targeted by the admin or where the user hasn't complied with the policies targeted by the admin. | 43 |
| error | Number of devices that failed to communicate with Intune or Microsoft Entra ID, and returned an error message. | 3 |
compliancePolicyStatusDevicePerPolicyActivities
The following table summarizes the assignment status of compliance policies to devices on a per policy and a per policy type basis. It lists the count of devices found in each compliance state for each assigned compliance policy.
| Property | Description | Example |
|---|---|---|
| dateKey | Date key when the summary was created for the compliance policy. | 20161219 |
| policyKey | Key for the compliance policy for which the summary was created. | 10178 |
| policyPlatformKey | Key for the platform type of the compliance policy for which the summary was created. | 5 |
| unknown | Number of devices that are offline or failed to communicate with Intune or Microsoft Entra ID for other reasons. | 13 |
| notApplicable | Number of devices where device compliance policies targeted by the admin are not applicable. | 3 |
| compliant | Number of devices that successfully applied one or more device compliance policies targeted by the admin. | 45 |
| inGracePeriod | Number of devices that are not compliant but that are in the grace-period defined by the admin. | 3 |
| nonCompliant | Number of devices that failed to apply one or more device compliance policies targeted by the admin or where the user hasn't complied with the policies targeted by the admin. | 7 |
| error | Number of devices that failed to communicate with Intune or Microsoft Entra ID, and returned an error message. | 3 |
policyPlatformTypes
The following table contains the platform types of all assigned policies. Policies platform types that have never been assigned to any devices are not present in this table.
| Property | Description | Example |
|---|---|---|
| policyPlatformTypeKey | The unique key for the policy platform type. | 20170519 |
| policyPlatformTypeId | The unique identifier for the policy platform type. | 1 |
| policyPlatformTypeName | The name for the policy platform type. | AndroidForWork |
policyDeviceActivities
The following table lists the number of devices in the succeeded, pending, failed, or error state per day. The number reflects the data per Policy Type profiles. For example, if a device is in the succeeded state for all its assigned policies, it increments the succeeded counter up one for that day. If a device has two profiles assigned to it, one in the succeeded state and another in an error state, the entity increments the Succeeded counter and place the device in the error state. The policyDeviceActivity entity lists how many devices are in which state on a given day over the last 30 days.
| Property | Description | Example |
|---|---|---|
| dateKey | Date Key when the Device Configuration Profile check-in was recorded in the data warehouse. | 20160703 |
| pending | Number of unique Devices in pending state. | 123 |
| Succeeded | Number of unique Devices in success state. | 12 |
| policyKey | policyKey, can be joined with policy to get the policyName. | Windows 10 baseline |
| error | Number of unique Devices in error state. | 10 |
| failed | Number of unique Devices in failed state. | 2 |
policyUserActivities
The following table lists the number of users in the succeeded, pending, failed, or error state per day. The number reflects the data per Policy Type profiles. For example, if a user is in the succeeded state for all their assigned policies, it moves up the succeeded counter by one for that day. If a user has two profiles assigned to them, one in the succeeded state and the other is in an error state, the user in the error state is counted. The PolicyUserActivity entity lists how many users are in which state on a given day over the last 30 days.
| Property | Description | Example |
|---|---|---|
| dateKey | Date Key when the Device Configuration Profile check-in was recorded in the data warehouse. | 20160703 |
| pending | Number of unique Devices in pending state. | 123 |
| succeeded | Number of unique Devices in success state. | 12 |
| policyKey | policyKey, can be joined with policy to get the policyName. | Windows 10 baseline |
| error | Number of unique Devices in error state. | 10 |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for