Тип ресурса 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. $Search не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
| emailAddress | String | Сообщения электронной почты для пользователя, связанного с устройством. Это свойство доступно только для чтения. |
| 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. $Search не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
| udid | String | Уникальный идентификатор устройства для устройств iOS и macOS. По умолчанию используется пустая строка. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Search не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
| notes | String | Заметки на устройстве, созданном ИТ-администратором. Значение по умолчанию равно NULL. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Search не поддерживается. |
| ethernetMacAddress | String | Указывает MAC-адрес Ethernet устройства. Значение по умолчанию равно NULL (свойство, отличное от по умолчанию) для этого свойства, если оно возвращается в составе объекта managedDevice. Для получения фактических значений требуется отдельный вызов get с параметрами выбора запроса. Пример: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Поддерживает: $select. $Search не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
| 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"
}