Справочник по объектам политики

Категория политик содержит сущности для мобильных устройств, которые отслеживают такие сведения, как:

  • Инвентаризация профилей конфигурации устройств, профилей конфигурации приложений и политик соответствия требованиям
  • Количество устройств в состоянии "Выполнено успешно", "Ожидание", "Сбой" или "Ошибка" в день
  • Количество пользователей в состоянии "Выполнено успешно", "Ожидает завершения", "Сбой" или "Ошибка" за день
  • Совокупное количество устройств в состоянии "Успешно", "Ожидание", "Сбой" или "Ошибка"

политики;

Объект политики перечисляет профили конфигурации устройств, профили конфигурации приложений и политики соответствия. Вы можете назначить политики с помощью Управление устройствами (MDM) группе в вашей организации.

Свойство Описание Пример
policyKey Уникальный ключ для представления политики в хранилище данных. 123
идентификатор политики Уникальный идентификатор политики в хранилище данных. b66bc706-ffff-7437-0340-032819502773
policyName Имя политики. "Базовый план Windows 10"
policyVersion Версия политики. При редактировании или изменении политики создается новая версия. 1, 2, 3
isDeleted Указывает, была ли обновлена запись политики.
True — политика имеет новую запись с обновленными полями.
False — последняя запись для полиса.
True/False
startDateInclusiveUTC Дата и время в формате UTC, когда политика была создана в хранилище данных. 23.11.2016 12:00:00
deletedDateUTC Дата и время в формате UTC, когда IsDeleted был изменен на True. 23.11.2016 12:00:00
rowLastModifiedDateTimeUTC Дата и время в формате UTC последнего изменения политики в хранилище данных. 23.11.2016 12:00:00

policyTypes

Объект policyType перечисляет типы профилей конфигурации устройств, профилей конфигурации приложений и политик соответствия. Вы можете назначить политики с помощью Управление устройствами (MDM) группе в вашей организации.

Свойство Описание Пример
policyTypeId Уникальный идентификатор политики в исходной системе. 123
policyTypeKey Уникальный идентификатор политики в хранилище данных. 1
policyTypeName Имя типа политики. Политика соответствия требованиям Windows 10.

Конфигурация устройств

Сущность deviceConfigurationProfileDeviceActivity перечисляет количество устройств в состоянии "Выполнено успешно", "Ожидание", "Сбой" или "Ошибка" за день. Число отражает профили конфигурации устройства, назначенные объекту. Например, если устройство находится в состоянии "Успешно" для всех назначенных ему политик, оно увеличивает счетчик успешного выполнения на единицу для этого дня. Если устройству назначено два профиля, один из которых находится в состоянии "Успешно", а другой в состоянии ошибки, объект увеличивает значение счетчика "Успешно" и переводит устройство в состояние ошибки. Объект перечисляет, сколько устройств находится в каком-либо состоянии в данный день за последние 30 дней.

Свойство Описание Пример
dateKey Ключ даты, когда проверка профиля конфигурации устройства была записана в хранилище данных. 20160703
Ожидание Количество уникальных устройств в состоянии ожидания. 123
успешно Количество уникальных устройств в состоянии успешного выполнения. 12
error Количество уникальных устройств в состоянии ошибки. 10
не удалось Количество уникальных устройств в состоянии сбоя. 2

Сущность deviceConfigurationProfileUserActivity перечисляет количество пользователей в состоянии "Успешно", "Ожидает завершения", "Сбой" или "Ошибка" за день. Число отражает профили конфигурации устройства, назначенные объекту. Например, если пользователь находится в состоянии "Успешно" для всех назначенных политик, он перемещает счетчик успешных действий на единицу вверх за этот день. Если пользователю назначено два профиля, один из которых находится в состоянии "Успешно", а другой находится в состоянии ошибки, то пользователь в состоянии ошибки учитывается. Сущность deviceConfigurationProfileUserActivity указывает, сколько пользователей находятся в каком-либо состоянии в данный день за последние 30 дней.

Свойство Описание Пример
dateKey Ключ даты, когда проверка профиля конфигурации устройства была записана в хранилище данных. 20160703
Ожидание Количество уникальных пользователей в состоянии ожидания. 123
успешно Количество уникальных пользователей в состоянии успешного выполнения. 12
error Количество уникальных пользователей в состоянии ошибки. 10
не удалось Количество уникальных пользователей в состоянии сбоя. 2

policyTypeActivities

Объект policyTypeActivity перечисляет совокупное количество устройств в состоянии "Успешно", "Ожидание", "Сбой" или "Ошибка". Эти состояния перечислены с учетом профиля конфигурации устройства, профиля конфигурации приложений или политики соответствия требованиям за день.

Свойство Описание Пример
dateKey date, когда проверка профиля конфигурации устройства была записана в хранилище данных. 20160703
policyKey policyKey может быть объединен с политикой для получения policyName. Базовый план Windows 10
policyTypeKey Тип ключа политики, может быть объединен с типом политики, чтобы получить имя типа политики. Политика соответствия требованиям Windows 10
Ожидание Количество уникальных устройств в состоянии ожидания. 123
успешно Количество уникальных устройств в состоянии успешного выполнения. 12
error Количество уникальных устройств в состоянии ошибки. 10
не удалось Количество уникальных устройств в состоянии сбоя. 2

Политика соответствия требованиям

Справочник по API политики соответствия содержит сущности, которые предоставляют информацию о состоянии политик соответствия требованиям, назначенных устройствам.

compliancePolicyStatusDeviceActivities

В следующей таблице обобщено состояние назначения политик соответствия требованиям для устройств. В нем перечислено количество устройств, обнаруженных в каждом состоянии соответствия.

Свойство Описание Пример
dateKey Ключ даты, когда была создана сводка для политики соответствия требованиям. 20161204
unknown Количество устройств, которые находятся в автономном режиме или не смогли связаться с Intune или Microsoft Entra ID по другим причинам. 5
неПрименимо Количество устройств, на которых не применяются политики соответствия устройств, на которые настроен администратор. 201
соответствует требованиям Количество устройств, успешно применивших одну или несколько политик соответствия устройств, выбранных администратором. 4083
inGracePeriod Количество несоответствующих устройств, но находящихся в льготном периоде, определенном администратором. 57
не соответствует Количество устройств, на которых не удалось применить одну или несколько политик соответствия устройств, выбранных администратором, или на которых пользователь не выполнил политики, назначенные администратором. 43
error Количество устройств, которые не смогли связаться с Intune или Microsoft Entra ID и вернули сообщение об ошибке. 3

compliancePolicyStatusDevicePerPolicyActivities

В следующей таблице обобщено состояние назначения политик соответствия устройствам для каждой политики и каждого типа политики. В нем перечислено количество устройств, найденных в каждом состоянии соответствия для каждой назначенной политики соответствия требованиям.

Свойство Описание Пример
dateKey Ключ даты, когда была создана сводка для политики соответствия требованиям. 20161219
policyKey Ключ для политики соответствия требованиям, для которой была создана сводка. 10178
policyPlatformKey Определите тип платформы политики соответствия требованиям, для которой была создана сводка. 5
unknown Количество устройств, которые находятся в автономном режиме или не смогли связаться с Intune или Microsoft Entra ID по другим причинам. 13
неПрименимо Количество устройств, на которых не применяются политики соответствия устройств, на которые настроен администратор. 3
соответствует требованиям Количество устройств, успешно применивших одну или несколько политик соответствия устройств, выбранных администратором. 45
inGracePeriod Количество несоответствующих устройств, но находящихся в льготном периоде, определенном администратором. 3
не соответствует Количество устройств, на которых не удалось применить одну или несколько политик соответствия устройств, выбранных администратором, или на которых пользователь не выполнил политики, назначенные администратором. 7
error Количество устройств, которые не смогли связаться с Intune или Microsoft Entra ID и вернули сообщение об ошибке. 3

policyPlatformTypes

Следующая таблица содержит типы платформ для всех назначенных политик. Политики Типы платформы, которые никогда не были назначены устройствам, отсутствуют в этой таблице.

Свойство Описание Пример
policyPlatformTypeKey Уникальный ключ для типа платформы политики. 20170519
policyPlatformTypeId Уникальный идентификатор типа платформы политики. 1
policyPlatformTypeName Имя типа платформы политики. AndroidForWork

policyDeviceActivities

В следующей таблице перечислено количество устройств в состоянии "Выполнено успешно", "Ожидание", "Сбой" или "Ошибка" за день. Число отражает данные по профилям типа политики. Например, если устройство находится в состоянии "Успешно" для всех назначенных ему политик, оно увеличивает счетчик успешного выполнения на единицу для этого дня. Если устройству назначено два профиля, один из которых находится в состоянии "Успешно", а другой в состоянии ошибки, объект увеличивает значение счетчика "Успешно" и переводит устройство в состояние ошибки. Объект policyDeviceActivity указывает, сколько устройств находится в каком состоянии в данный день за последние 30 дней.

Свойство Описание Пример
dateKey Ключ даты, когда проверка профиля конфигурации устройства была записана в хранилище данных. 20160703
Ожидание Количество уникальных устройств в состоянии ожидания. 123
Succeeded Количество уникальных устройств в состоянии успешного выполнения. 12
policyKey policyKey может быть объединен с политикой для получения policyName. Базовый план Windows 10
error Количество уникальных устройств в состоянии ошибки. 10
не удалось Количество уникальных устройств в состоянии сбоя. 2

policyUserActivities

В следующей таблице указано количество пользователей за день, в состоянии "Успешно", "Ожидает завершения", "Сбой" или "Ошибка". Число отражает данные по профилям типа политики. Например, если пользователь находится в состоянии "Успешно" для всех назначенных политик, он перемещает счетчик успешных действий на единицу вверх за этот день. Если пользователю назначено два профиля, один из которых находится в состоянии "Успешно", а другой находится в состоянии ошибки, то пользователь в состоянии ошибки учитывается. Сущность PolicyUserActivity указывает, сколько пользователей находятся в каком состоянии в данный день за последние 30 дней.

Свойство Описание Пример
dateKey Ключ даты, когда проверка профиля конфигурации устройства была записана в хранилище данных. 20160703
Ожидание Количество уникальных устройств в состоянии ожидания. 123
успешно Количество уникальных устройств в состоянии успешного выполнения. 12
policyKey policyKey может быть объединен с политикой для получения policyName. Базовый план Windows 10
error Количество уникальных устройств в состоянии ошибки. 10