Тип ресурса managedDevice

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

Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.

Устройства, которые управляются или предварительно регистрируются с помощью Intune

Методы

Метод	Возвращаемый тип	Описание
Перечисление объектов managedDevice	Коллекция managedDevice	Перечисление свойств и связей объектов managedDevice.
Получение объекта managedDevice	managedDevice	Чтение свойств и связей объекта managedDevice.
Создание объекта managedDevice	managedDevice	Создание объекта managedDevice.
Удаление объекта managedDevice	Нет	Удаление объекта managedDevice.
Обновление объекта managedDevice	managedDevice	Обновление свойств объекта managedDevice.

|Действие снятия с учета|Нет|Прекращение использования устройства| |Действие очистки|Нет|Очистка устройства| |действие resetPasscode |Нет|Сброс секретного кода| |Действие remoteLock|Нет|Удаленная блокировка| |действие requestRemoteAssistance|Нет|Запрос удаленной помощи| |Действие disableLostMode|Нет|Отключить режим пропажи| |Действие locateDevice |Нет|Поиск устройства| |Действие bypassActivationLock|Нет|Обход блокировки активации| |Действие rebootNow |Нет|Перезагрузка устройства| |Действие shutDown|Нет|Завершение работы устройства| |действие recoverPasscode|Нет|Восстановление секретного кода| |CleanWindowsDevice action |Нет|Очистка устройства с Windows| |действие logoutSharedAppleDeviceActiveUser |Нет|Выйдите из общего активного пользователя устройства Apple| |Действие deleteUserFromSharedAppleDevice|Нет|Удаление пользователя с общего устройства Apple| |действие syncDevice|Нет|| |Действие windowsDefenderScan|Нет|| |Действие windowsDefenderUpdateSignatures|Нет|| |updateWindowsDeviceAccount action|Нет||

Свойства

Свойство	Тип	Описание
id	String	Уникальный идентификатор устройства. Это свойство доступно только для чтения.
userId	String	Уникальный идентификатор пользователя, связанного с устройством. Это свойство доступно только для чтения.
deviceName	String	Имя устройства. Это свойство доступно только для чтения.
managedDeviceOwnerType	managedDeviceOwnerType	Владение устройством. Может быть "корпоративным" или "личным". Возможные значения: unknown, company, personal.
deviceActionResults	Коллекция deviceActionResult	Список объектов deviceActionResult сложного типа. Это свойство доступно только для чтения.
enrolledDateTime	DateTimeOffset	Время регистрации устройства. Поддерживает операторы $filter "lt" и "gt". Это свойство доступно только для чтения.
lastSyncDateTime	DateTimeOffset	Дата и время последней успешной синхронизации устройства с Intune. Поддерживает операторы $filter "lt" и "gt". Это свойство доступно только для чтения.
operatingSystem	String	Операционная система устройства. Windows, iOS и т. д. Это свойство доступно только для чтения.
complianceState	complianceState	Состояние соответствия устройства требованиям. Примеры: соответствие, конфликт, ошибка и т. д. Значение по умолчанию неизвестно. Поддерживает операторы $filter eq и or. Это свойство доступно только для чтения. Возможные значения: unknown, compliant, noncompliant, conflict, error, inGracePeriod, configManager.
jailBroken	String	Сломано или укоренен ли устройство в тюрьме. По умолчанию используется пустая строка. Поддерживает операторы $filter eq и or. Это свойство доступно только для чтения.
managementAgent	managementAgentType	Канал управления устройством. Примеры: Intune, EAS и т. д. Значение по умолчанию неизвестно. Поддерживает операторы $filter eq и or. Это свойство доступно только для чтения. Возможные значения: eas, mdm, easMdm, intuneClient, easIntuneClient, configurationManagerClient, configurationManagerClientMdm, configurationManagerClientMdmEas, unknown, jamf, googleCloudDevicePolicyController.
osVersion	String	Версия операционной системы устройства. Это свойство доступно только для чтения.
easActivated	Boolean	Указывает, активировано ли устройство в Exchange ActiveSync. Это свойство доступно только для чтения.
easDeviceId	String	Идентификатор устройства в Exchange ActiveSync. Это свойство доступно только для чтения.
easActivationDateTime	DateTimeOffset	Время активации устройства в Exchange ActivationSync. Это свойство доступно только для чтения.
azureADRegistered	Boolean	Указывает, зарегистрировано ли устройство в Azure Active Directory. Это свойство доступно только для чтения.
deviceEnrollmentType	deviceEnrollmentType	Тип регистрации устройства. Это свойство доступно только для чтения. Возможные значения: unknown, userEnrollment, deviceEnrollmentManager, appleBulkWithUser, appleBulkWithoutUser, windowsAzureADJoin, windowsBulkUserless, windowsAutoEnrollment, windowsBulkAzureDomainJoin, windowsCoManagement, windowsAzureADJoinUsingDeviceAuth, appleUserEnrollment, appleUserEnrollmentWithServiceAccount.
activationLockBypassCode	String	Код, позволяющий обойти блокировку активации на управляемом устройстве. Значение по умолчанию — NULL (свойство, отличное от значения по умолчанию) для этого свойства, если оно возвращается в составе сущности managedDevice в вызове LIST. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Поиск не поддерживается. Только для чтения. Это свойство доступно только для чтения.
emailAddress	String	Email для пользователя, связанного с устройством. Это свойство доступно только для чтения.
azureADDeviceId	String	Уникальный идентификатор устройства Azure Active Directory. Только для чтения. Это свойство доступно только для чтения.
deviceRegistrationState	deviceRegistrationState	Состояние регистрации устройства. Это свойство доступно только для чтения. Возможные значения: notRegistered, registered, revoked, keyConflict, approvalPending, certificateReset, notRegisteredPendingEnrollment, unknown.
deviceCategoryDisplayName	String	Отображаемое имя категории устройств. По умолчанию используется пустая строка. Поддерживает операторы $filter eq и or. Это свойство доступно только для чтения.
isSupervised	Логический	Состояние защищенного устройства. Это свойство доступно только для чтения.
exchangeLastSuccessfulSyncDateTime	DateTimeOffset	Время последнего подключения устройства к Exchange. Это свойство доступно только для чтения.
exchangeAccessState	deviceManagementExchangeAccessState	Состояние доступа к устройству в Exchange. Это свойство доступно только для чтения. Возможные значения: none, unknown, allowed, blocked, quarantined.
exchangeAccessStateReason	deviceManagementExchangeAccessStateReason	Причина состояния доступа к устройству в Exchange. Это свойство доступно только для чтения. Возможные значения: none, unknown, exchangeGlobalRule, exchangeIndividualRule, exchangeDeviceRule, exchangeUpgrade, exchangeMailboxPolicy, other, compliant, notCompliant, notEnrolled, unknownLocation, mfaRequired, azureADBlockDueToAccessPolicy, compromisedPassword, deviceNotKnownWithManagedApp.
remoteAssistanceSessionUrl	String	URL-адрес, позволяющий установить сеанс удаленного помощника с устройством. По умолчанию используется пустая строка. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Это свойство доступно только для чтения.
remoteAssistanceSessionErrorDetails	String	Проблемы, возникающие при создании сеансов удаленного помощника. Это свойство доступно только для чтения.
isEncrypted	Логический	Состояние шифрования устройства. Это свойство доступно только для чтения.
userPrincipalName	String	Имя субъекта-пользователя устройства. Это свойство доступно только для чтения.
model	String	Модель устройства. Это свойство доступно только для чтения.
manufacturer	String	Производитель устройства. Это свойство доступно только для чтения.
imei	String	IMEI. Это свойство доступно только для чтения.
complianceGracePeriodExpirationDateTime	DateTimeOffset	Дата и время окончания льготного периода соответствия устройств. Это свойство доступно только для чтения.
serialNumber	String	SerialNumber. Это свойство доступно только для чтения.
phoneNumber	String	Номер телефона устройства. Это свойство доступно только для чтения.
androidSecurityPatchLevel	String	Уровень исправлений для системы безопасности Android. Это свойство доступно только для чтения.
userDisplayName	String	Отображаемое имя пользователя. Это свойство доступно только для чтения.
configurationManagerClientEnabledFeatures	configurationManagerClientEnabledFeatures	Функции клиента ConfigrMgr. Это свойство доступно только для чтения.
wiFiMacAddress	String	Wi-Fi MAC. Это свойство доступно только для чтения.
deviceHealthAttestationState	deviceHealthAttestationState	Состояние подтверждения работоспособности устройства. Это свойство доступно только для чтения.
subscriberCarrier	String	Оператор подписчика. Это свойство доступно только для чтения.
meid	String	MEID. Это свойство доступно только для чтения.
totalStorageSpaceInBytes	Int64	Общий объем хранилища в байтах. Это свойство доступно только для чтения.
freeStorageSpaceInBytes	Int64	Бесплатное хранилище в байтах. Значение по умолчанию: 0. Только для чтения. Это свойство доступно только для чтения.
managedDeviceName	String	Автоматически созданный идентификатор устройства. Может быть заменен понятным именем.
partnerReportedThreatState	managedDevicePartnerReportedHealthState	Указывает состояние подверженности устройства угрозам при использовании решения Mobile Threat Defense (в учетной записи и на устройстве). Только для чтения. Это свойство доступно только для чтения. Возможные значения: unknown, activated, deactivated, secured, lowSeverity, mediumSeverity, highSeverity, unresponsive, compromised, misconfigured.
requireUserEnrollmentApproval	Логический	Сообщает, что управляемое устройство iOS зарегистрировано для утверждения пользователем. Это свойство доступно только для чтения.
managementCertificateExpirationDate	DateTimeOffset	Сообщает об истечении срока действия сертификата управления устройствами. Это свойство доступно только для чтения.
Iccid	String	Идентификатор карточки интегральной цепи, это уникальный идентификационный номер SIM-карта. По умолчанию используется пустая строка. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Поиск не поддерживается. Только для чтения. Это свойство доступно только для чтения.
udid	String	Уникальный идентификатор устройства для устройств iOS и macOS. По умолчанию используется пустая строка. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Поиск не поддерживается. Только для чтения. Это свойство доступно только для чтения.
notes	String	Заметки на устройстве, созданном ИТ-Администратор. Значение по умолчанию — NULL. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Поиск не поддерживается.
ethernetMacAddress	String	Указывает MAC-адрес Ethernet устройства. Значение по умолчанию равно NULL (свойство, отличное от по умолчанию) для этого свойства, если оно возвращается в составе объекта managedDevice. Для получения фактических значений требуется отдельный вызов get с параметрами выбора запроса. Пример: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Поддерживает: $select. $Поиск не поддерживается. Только для чтения. Это свойство доступно только для чтения.
physicalMemoryInBytes	Int64	Общий объем памяти в байтах. Значение по умолчанию — 0. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. Только для чтения. Это свойство доступно только для чтения.
enrollmentProfileName	String	Имя профиля регистрации, назначенного устройству. Значение по умолчанию — пустая строка, указывающая, что профиль регистрации не был настроен. Это свойство доступно только для чтения.

Связи

Связь	Тип	Описание
deviceCategory	deviceCategory	Категория устройств
windowsProtectionState	windowsProtectionState	Состояние защиты устройства. Это свойство доступно только для чтения.
users	Коллекция объектов user	Основные пользователи, связанные с управляемым устройством.
logCollectionRequests	коллекция deviceLogCollectionResponse	Список запросов на сбор журналов

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

Ниже представлено описание ресурса в формате JSON.

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "id": "String (identifier)",
  "userId": "String",
  "deviceName": "String",
  "managedDeviceOwnerType": "String",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "String",
      "actionState": "String",
      "startDateTime": "String (timestamp)",
      "lastUpdatedDateTime": "String (timestamp)"
    }
  ],
  "enrolledDateTime": "String (timestamp)",
  "lastSyncDateTime": "String (timestamp)",
  "operatingSystem": "String",
  "complianceState": "String",
  "jailBroken": "String",
  "managementAgent": "String",
  "osVersion": "String",
  "easActivated": true,
  "easDeviceId": "String",
  "easActivationDateTime": "String (timestamp)",
  "azureADRegistered": true,
  "deviceEnrollmentType": "String",
  "activationLockBypassCode": "String",
  "emailAddress": "String",
  "azureADDeviceId": "String",
  "deviceRegistrationState": "String",
  "deviceCategoryDisplayName": "String",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "String (timestamp)",
  "exchangeAccessState": "String",
  "exchangeAccessStateReason": "String",
  "remoteAssistanceSessionUrl": "String",
  "remoteAssistanceSessionErrorDetails": "String",
  "isEncrypted": true,
  "userPrincipalName": "String",
  "model": "String",
  "manufacturer": "String",
  "imei": "String",
  "complianceGracePeriodExpirationDateTime": "String (timestamp)",
  "serialNumber": "String",
  "phoneNumber": "String",
  "androidSecurityPatchLevel": "String",
  "userDisplayName": "String",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true
  },
  "wiFiMacAddress": "String",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "String",
    "contentNamespaceUrl": "String",
    "deviceHealthAttestationStatus": "String",
    "contentVersion": "String",
    "issuedDateTime": "String (timestamp)",
    "attestationIdentityKey": "String",
    "resetCount": 1024,
    "restartCount": 1024,
    "dataExcutionPolicy": "String",
    "bitLockerStatus": "String",
    "bootManagerVersion": "String",
    "codeIntegrityCheckVersion": "String",
    "secureBoot": "String",
    "bootDebugging": "String",
    "operatingSystemKernelDebugging": "String",
    "codeIntegrity": "String",
    "testSigning": "String",
    "safeMode": "String",
    "windowsPE": "String",
    "earlyLaunchAntiMalwareDriverProtection": "String",
    "virtualSecureMode": "String",
    "pcrHashAlgorithm": "String",
    "bootAppSecurityVersion": "String",
    "bootManagerSecurityVersion": "String",
    "tpmVersion": "String",
    "pcr0": "String",
    "secureBootConfigurationPolicyFingerPrint": "String",
    "codeIntegrityPolicy": "String",
    "bootRevisionListInfo": "String",
    "operatingSystemRevListInfo": "String",
    "healthStatusMismatchInfo": "String",
    "healthAttestationSupportedStatus": "String"
  },
  "subscriberCarrier": "String",
  "meid": "String",
  "totalStorageSpaceInBytes": 1024,
  "freeStorageSpaceInBytes": 1024,
  "managedDeviceName": "String",
  "partnerReportedThreatState": "String",
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "String (timestamp)",
  "iccid": "String",
  "udid": "String",
  "notes": "String",
  "ethernetMacAddress": "String",
  "physicalMemoryInBytes": 1024,
  "enrollmentProfileName": "String"
}