Тип ресурса device

Пространство имен: microsoft.graph

Представляет устройство, зарегистрированное в организации. Экземпляры device создаются в облаке с помощью службы Device Registration Service или Intune. Их используют политики условного доступа для многофакторной проверки подлинности. Представленными устройствами могут быть компьютеры и ноутбуки, смартфоны и планшеты. Наследуется от directoryObject.

Этот ресурс имеет открытый тип, который допускает дополнительные свойства, помимо описанных здесь.

Этот ресурс поддерживает:

• добавление собственных данных к настраиваемым свойствам в виде расширений;
• отслеживание дополнений, удалений и обновлений с помощью запроса изменений (функция delta).
• Возможности запросов OData, включая $select, $filter, $searchи $top. Определенные варианты использования поддерживаются только возможностями расширенных запросов.

Методы

Метод	Возвращаемый тип	Описание
Список	Коллекция device	Получение списка устройств, зарегистрированных в каталоге.
Создание	device	Зарегистрируйте новое устройство в каталоге.
Получение	device	Считывание свойств и отношений объекта device.
Обновление	device	Обновление свойств, принадлежащих объекту device.
Delete	Нет	Удаление объекта device.
Устройство: подготовка к работе	provisionResponse	Подготовка устройства от имени утвержденного поставщика инфраструктуры виртуальных рабочих столов (VDI).
Получение дельты	Коллекция объектов device	Получение добавочных изменений для устройств.
Список свойств member of	Коллекция directoryObject	Укажите группы и административные единицы, непосредственным членом которых является устройство.
Укажите транзитивный член	Коллекция directoryObject	Укажите группы и административные единицы, участником которых является устройство. Эта операция является транзитивной.
Список зарегистрированных владельцев	Коллекция directoryObject	Получение пользователей, которые относятся к зарегистрированным владельцам устройства, из свойства навигации registeredOwners.
Добавление зарегистрированных владельцев	Коллекция directoryObject	Добавьте зарегистрированных владельцев устройства.
Удаление зарегистрированных владельцев	Коллекция directoryObject	Удаление зарегистрированных владельцев с устройства.
Список зарегистрированных пользователей	Коллекция directoryObject	Получение зарегистрированных пользователей устройства из свойства навигации registeredUsers.
Добавление зарегистрированных пользователей	Коллекция directoryObject	Добавьте зарегистрированных пользователей устройства.
Удаление зарегистрированных пользователей	Коллекция directoryObject	Удалите зарегистрированных пользователей с устройства.
Проверка объектов-элементов	Коллекция строк	Проверяйте наличие членства в списке объектов, групп, каталога или административных единиц.
Вывод объектов членства	Коллекция строк	Верните все группы, административные подразделения и роли каталогов, участником которых является устройство. Это транзитивная проверка.

Свойства

Важно!

Определенное использование $filter и параметра запроса $search поддерживается только при применении заголовка ConsistencyLevel с присвоенным значением eventual и $count. Дополнительные сведения см. в статье Расширенные возможности запросов для объектов каталога.

Свойство	Тип	Описание
accountEnabled	Логический	Если учетная запись обеспечена — true, в противном случае — false. Обязательно. Значение по умолчанию: true. Поддерживает $filter (eq, ne, not, in). Это свойство могут задать только вызывающие абоненты хотя бы с ролью администратора облачных устройств.
alternativeSecurityIds	Коллекция alternativeSecurityId	Только для внутреннего использования. Значение null не допускается. Поддерживает $filter (eq, not, ge, le).
approximateLastSignInDateTime	DateTimeOffset	Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда имеет формат UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Только для чтения. Поддерживает $filter значения (eq, ne, not, ge, leи eq on null ) и $orderby.
complianceExpirationDateTime	DateTimeOffset	Метка времени, когда устройство больше не считается соответствующим требованиям. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда имеет формат UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Только для чтения.
deviceCategory	String	Определяемое пользователем свойство, заданное Intune для автоматического добавления устройств в группы и упрощения управления устройствами.
deviceId	String	Уникальный идентификатор, задаваемый службой Azure Device Registration Service при регистрации. Этот альтернативный ключ можно использовать для ссылки на объект устройства. Поддерживает $filter (eq, ne, not, startsWith).
deviceMetadata	String	Только для внутреннего использования. Установите значение null.
deviceOwnership	String	Владение устройством. Это свойство задает Intune. Допустимые значения: unknown, company, personal.
deviceVersion	Int32	Только для внутреннего использования.
displayName	String	Отображаемое имя устройства. Максимальная длина: 256 символов. Обязательно. Поддерживает $filter (eq, ne, not, ge, le, in, startsWith и eq для значений null), $search и $orderby.
enrollmentProfileName	String	Профиль регистрации, примененный к устройству. Например, Apple Device Enrollment Profile, Device enrollment - Corporate device identifiers или Windows Autopilot profile name. Это свойство задается Intune.
enrollmentType	String	Тип регистрации устройства. Это свойство задает Intune. Возможные значения: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser.appleUserEnrollmentappleUserEnrollmentWithServiceAccountappleBulkWithoutUserwindowsAzureADJoinwindowsBulkUserlesswindowsAutoEnrollmentwindowsBulkAzureDomainJoinwindowsCoManagementwindowsAzureADJoinUsingDeviceAuth ПРИМЕЧАНИЕ. Это свойство может возвращать другие значения, отличные от перечисленных.
extensionAttributes	onPremisesExtensionAttributes	Содержит атрибуты расширения 1–15 для устройства. Отдельные атрибуты расширения не выбираются. Эти свойства управляются в облаке и могут быть установлены во время создания или обновления объекта устройства в Microsoft Entra ID. Поддерживает $filter (eq, not, startsWith и eq по null значениям).
id	Строка	Уникальный идентификатор устройства. Наследуется из directoryObject. Ключ, значение null не допускается. Только для чтения. Поддерживает $filter (eq, ne, not, in).
isCompliant	Логический	trueесли устройство соответствует политикам мобильного Управление устройствами (MDM), в противном случае false Только для чтения. Это может быть обновлено только с помощью Intune для любого типа ОС устройства или утвержденным приложением MDM для устройств с ОС Windows. Поддерживает $filter (eq, ne, not).
isManaged	Логический	trueесли устройством управляет приложение мобильного Управление устройствами (MDM), в противном случае false Это может быть обновлено только с помощью Intune для любого типа ОС устройства или утвержденным приложением MDM для устройств с ОС Windows. Поддерживает $filter (eq, ne, not).
isManagementRestricted	Логический	Указывает, является ли устройство членом административной единицы ограниченного управления. Если не установлено, значением по умолчанию является null "false". Только для чтения. Чтобы управлять устройством, которое является членом административной единицы ограниченного управления, администратору или вызывающему приложению должна быть назначена роль Microsoft Entra в области административной единицы ограниченного управления. Требуется $select получение.
isRooted	Логический	true Если устройство является рутовым или взломанным. Это свойство может быть обновлено только с помощью Intune.
managementType	String	Канал управления устройства. Это свойство задается Intune. Возможные значения: eas, mdm, easMdm, googleCloudDevicePolicyControllerjamfconfigurationManagerClientMdmEasconfigurationManagerClientunknownintuneClienteasIntuneClientconfigurationManagerClientMdm.
manufacturer	String	Производитель устройства. Только для чтения.
mdmAppId	String	Идентификатор приложения, используемый для регистрации устройства в MDM. Только для чтения. Поддерживает $filter (eq, ne, not, startsWith).
model	String	Модель устройства. Только для чтения.
onPremisesLastSyncDateTime	DateTimeOffset	Время последней синхронизации объекта с локальным каталогом. Тип Timestamp представляет сведения о времени и дате с использованием формата ISO 8601 (всегда применяется формат UTC). Например, полночь по UTC 1 января 2014 г. доступна 2014-01-01T00:00:00Z только для чтения. Поддерживает $filter (eq, ne, not, ge, le, in).
onPremisesSecurityIdentifier	String	Локальный идентификатор безопасности (SID) пользователя, синхронизированный из локальной среды в облако. Только для чтения. Требуется $select получение. Поддерживает $filter (eq).
onPremisesSyncEnabled	Логический	Значение true указывает, что этот объект синхронизируется из локального каталога. Значение false указывает, что этот объект ранее синхронизировался из локального каталога, но синхронизация больше не выполняется. Значение null указывает, что этот объект никогда не синхронизировался из локального каталога (значение по умолчанию). Только для чтения. Поддерживает $filter (eq, ne, not, in и eq для значений null).
operatingSystem	String	Тип операционной системы на устройстве. Обязательно. Поддерживает $filter значения (eq, ne, not, ge, le, startsWithи eq on null ).
operatingSystemVersion	Строка	Версия операционной системы на устройстве. Обязательно. Поддерживает $filter значения (eq, ne, not, ge, le, startsWithи eq on null ).
physicalIds	Коллекция строк	Только для внутреннего использования. Значение null не допускается. Поддерживает $filter (eq, not, ge, lestartsWith, ,, /$count ne 0)./$count eq 0
profileType	deviceProfileType	Тип профиля устройства. Возможные значения: RegisteredDevice (по умолчанию), SecureVM, Printer, Shared, . IoT
registrationDateTime	DateTimeOffset	Дата и время регистрации устройства. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда имеет формат UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z. Только для чтения.
systemLabels	Коллекция строк	Список меток, примененных системой к устройству. Поддерживает $filter (/$count eq 0, /$count ne 0).
trustType	String	Тип доверия для присоединенного устройства. Только для чтения. Возможные значения: Workplace (указывает использование собственных личных устройств), (устройства, AzureAd присоединенные только к облаку), (локальные устройства, присоединенные к домену, ServerAd присоединенные к Microsoft Entra ID). Дополнительные сведения см. в разделе «Введение в управление устройствами в Microsoft Entra ID». Поддерживает $filter (eq, ne, not, in).

Связи

Связь	Тип	Описание
extensions	Коллекция extension	Коллекция открытых расширений, определенных для устройства. Только для чтения. Допускается значение null.
memberOf	Коллекция directoryObject	Группы и административные единицы, участником которых является это устройство. Только для чтения. Допускается значение null. Поддерживает $expand.
registeredOwners	Коллекция directoryObject	Пользователь, который присоединил устройство через облако или зарегистрировал личное устройство. Зарегистрированный владелец задается при регистрации. Только для чтения. Допускается значение null. Поддерживает $expand.
registeredUsers	Коллекция directoryObject	Коллекция зарегистрированных пользователей устройства. В случае зарегистрированных личных устройств или устройств, присоединенных через облако, при регистрации для обычных пользователей задается то же значение, что и для владельцев. Только для чтения. Допускается значение null. Поддерживает $expand.
transitiveMemberOf	Коллекция directoryObject	Группы и административные единицы, в состав которых входит устройство. Эта операция является транзитивной. Поддерживает $expand.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "accountEnabled": "Boolean",
  "alternativeSecurityIds": [{"@odata.type": "microsoft.graph.alternativeSecurityId"}],
  "approximateLastSignInDateTime": "String (timestamp)",
  "complianceExpirationDateTime": "String (timestamp)",
  "deviceCategory": "String",
  "deviceId": "String",
  "deviceMetadata": "String",
  "deviceOwnership": "String",
  "deviceVersion": "Int32",
  "displayName": "String",
  "enrollmentProfileName": "String",
  "enrollmentType": "String",
  "extensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
  "id": "String (identifier)",
  "isCompliant": "Boolean",
  "isManaged": "Boolean",
  "isManagementRestricted": "Boolean",
  "isRooted": "Boolean",
  "managementType": "String",
  "manufacturer": "String",
  "mdmAppId": "String",
  "model": "String",
  "onPremisesLastSyncDateTime": "String (timestamp)",
  "onPremisesSecurityIdentifier": "String",
  "onPremisesSyncEnabled": "Boolean",
  "operatingSystem": "String",
  "operatingSystemVersion": "String",
  "physicalIds": ["String"],
  "profileType": "String",
  "registrationDateTime": "String (timestamp)",
  "systemLabels": ["String"],
  "trustType": "String"
}

Связанные материалы

• Добавление пользовательских данных в ресурсы с помощью расширений
• Добавление пользовательских данных в ресурсы user с помощью открытых расширений
• Добавление пользовательских данных в группы с помощью расширений схемы