Поделиться через

Create managedDevice

  • Статья

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

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

Создание объекта managedDevice.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись) DeviceManagementManagedDevices.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение DeviceManagementManagedDevices.ReadWrite.All

HTTP-запрос

POST /deviceManagement/managedDevices
POST /deviceManagement/detectedApps/{detectedAppId}/managedDevices
POST /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/users/{userId}/managedDevices

Заголовки запроса

Заголовок Значение
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
Accept application/json

Текст запроса

В тексте запроса добавьте представление объекта managedDevice в формате JSON.

В приведенной ниже таблице показаны свойства, которые необходимо указывать при создании объекта managedDevice.

Свойство Тип Описание
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 Имя профиля регистрации, назначенного устройству. Значение по умолчанию — пустая строка, указывающая, что профиль регистрации не был настроен. Это свойство доступно только для чтения.

Отклик

В случае успешного выполнения этот метод возвращает код ответа 201 Created и объект managedDevice в тексте ответа.

Пример

Запрос

Ниже приведен пример запроса.

POST https://graph.microsoft.com/v1.0/deviceManagement/managedDevices
Content-type: application/json
Content-length: 5058

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "userId": "User Id value",
  "deviceName": "Device Name value",
  "managedDeviceOwnerType": "company",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ],
  "enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "operatingSystem": "Operating System value",
  "complianceState": "compliant",
  "jailBroken": "Jail Broken value",
  "managementAgent": "mdm",
  "osVersion": "Os Version value",
  "easActivated": true,
  "easDeviceId": "Eas Device Id value",
  "easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
  "azureADRegistered": true,
  "deviceEnrollmentType": "userEnrollment",
  "activationLockBypassCode": "Activation Lock Bypass Code value",
  "emailAddress": "Email Address value",
  "azureADDeviceId": "Azure ADDevice Id value",
  "deviceRegistrationState": "registered",
  "deviceCategoryDisplayName": "Device Category Display Name value",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
  "exchangeAccessState": "unknown",
  "exchangeAccessStateReason": "unknown",
  "remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
  "remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
  "isEncrypted": true,
  "userPrincipalName": "User Principal Name value",
  "model": "Model value",
  "manufacturer": "Manufacturer value",
  "imei": "Imei value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "serialNumber": "Serial Number value",
  "phoneNumber": "Phone Number value",
  "androidSecurityPatchLevel": "Android Security Patch Level value",
  "userDisplayName": "User Display Name value",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true
  },
  "wiFiMacAddress": "Wi Fi Mac Address value",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "Last Update Date Time value",
    "contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
    "deviceHealthAttestationStatus": "Device Health Attestation Status value",
    "contentVersion": "Content Version value",
    "issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
    "attestationIdentityKey": "Attestation Identity Key value",
    "resetCount": 10,
    "restartCount": 12,
    "dataExcutionPolicy": "Data Excution Policy value",
    "bitLockerStatus": "Bit Locker Status value",
    "bootManagerVersion": "Boot Manager Version value",
    "codeIntegrityCheckVersion": "Code Integrity Check Version value",
    "secureBoot": "Secure Boot value",
    "bootDebugging": "Boot Debugging value",
    "operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
    "codeIntegrity": "Code Integrity value",
    "testSigning": "Test Signing value",
    "safeMode": "Safe Mode value",
    "windowsPE": "Windows PE value",
    "earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
    "virtualSecureMode": "Virtual Secure Mode value",
    "pcrHashAlgorithm": "Pcr Hash Algorithm value",
    "bootAppSecurityVersion": "Boot App Security Version value",
    "bootManagerSecurityVersion": "Boot Manager Security Version value",
    "tpmVersion": "Tpm Version value",
    "pcr0": "Pcr0 value",
    "secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
    "codeIntegrityPolicy": "Code Integrity Policy value",
    "bootRevisionListInfo": "Boot Revision List Info value",
    "operatingSystemRevListInfo": "Operating System Rev List Info value",
    "healthStatusMismatchInfo": "Health Status Mismatch Info value",
    "healthAttestationSupportedStatus": "Health Attestation Supported Status value"
  },
  "subscriberCarrier": "Subscriber Carrier value",
  "meid": "Meid value",
  "totalStorageSpaceInBytes": 8,
  "freeStorageSpaceInBytes": 7,
  "managedDeviceName": "Managed Device Name value",
  "partnerReportedThreatState": "activated",
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
  "iccid": "Iccid value",
  "udid": "Udid value",
  "notes": "Notes value",
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,  
  "enrollmentProfileName": "Enrollment Profile Name value"
}

Отклик

Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 5107

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "id": "705c034c-034c-705c-4c03-5c704c035c70",
  "userId": "User Id value",
  "deviceName": "Device Name value",
  "managedDeviceOwnerType": "company",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ],
  "enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
  "lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
  "operatingSystem": "Operating System value",
  "complianceState": "compliant",
  "jailBroken": "Jail Broken value",
  "managementAgent": "mdm",
  "osVersion": "Os Version value",
  "easActivated": true,
  "easDeviceId": "Eas Device Id value",
  "easActivationDateTime": "2016-12-31T23:59:43.4878784-08:00",
  "azureADRegistered": true,
  "deviceEnrollmentType": "userEnrollment",
  "activationLockBypassCode": "Activation Lock Bypass Code value",
  "emailAddress": "Email Address value",
  "azureADDeviceId": "Azure ADDevice Id value",
  "deviceRegistrationState": "registered",
  "deviceCategoryDisplayName": "Device Category Display Name value",
  "isSupervised": true,
  "exchangeLastSuccessfulSyncDateTime": "2017-01-01T00:00:45.8803083-08:00",
  "exchangeAccessState": "unknown",
  "exchangeAccessStateReason": "unknown",
  "remoteAssistanceSessionUrl": "https://example.com/remoteAssistanceSessionUrl/",
  "remoteAssistanceSessionErrorDetails": "Remote Assistance Session Error Details value",
  "isEncrypted": true,
  "userPrincipalName": "User Principal Name value",
  "model": "Model value",
  "manufacturer": "Manufacturer value",
  "imei": "Imei value",
  "complianceGracePeriodExpirationDateTime": "2016-12-31T23:56:44.951111-08:00",
  "serialNumber": "Serial Number value",
  "phoneNumber": "Phone Number value",
  "androidSecurityPatchLevel": "Android Security Patch Level value",
  "userDisplayName": "User Display Name value",
  "configurationManagerClientEnabledFeatures": {
    "@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
    "inventory": true,
    "modernApps": true,
    "resourceAccess": true,
    "deviceConfiguration": true,
    "compliancePolicy": true,
    "windowsUpdateForBusiness": true
  },
  "wiFiMacAddress": "Wi Fi Mac Address value",
  "deviceHealthAttestationState": {
    "@odata.type": "microsoft.graph.deviceHealthAttestationState",
    "lastUpdateDateTime": "Last Update Date Time value",
    "contentNamespaceUrl": "https://example.com/contentNamespaceUrl/",
    "deviceHealthAttestationStatus": "Device Health Attestation Status value",
    "contentVersion": "Content Version value",
    "issuedDateTime": "2016-12-31T23:58:22.1231038-08:00",
    "attestationIdentityKey": "Attestation Identity Key value",
    "resetCount": 10,
    "restartCount": 12,
    "dataExcutionPolicy": "Data Excution Policy value",
    "bitLockerStatus": "Bit Locker Status value",
    "bootManagerVersion": "Boot Manager Version value",
    "codeIntegrityCheckVersion": "Code Integrity Check Version value",
    "secureBoot": "Secure Boot value",
    "bootDebugging": "Boot Debugging value",
    "operatingSystemKernelDebugging": "Operating System Kernel Debugging value",
    "codeIntegrity": "Code Integrity value",
    "testSigning": "Test Signing value",
    "safeMode": "Safe Mode value",
    "windowsPE": "Windows PE value",
    "earlyLaunchAntiMalwareDriverProtection": "Early Launch Anti Malware Driver Protection value",
    "virtualSecureMode": "Virtual Secure Mode value",
    "pcrHashAlgorithm": "Pcr Hash Algorithm value",
    "bootAppSecurityVersion": "Boot App Security Version value",
    "bootManagerSecurityVersion": "Boot Manager Security Version value",
    "tpmVersion": "Tpm Version value",
    "pcr0": "Pcr0 value",
    "secureBootConfigurationPolicyFingerPrint": "Secure Boot Configuration Policy Finger Print value",
    "codeIntegrityPolicy": "Code Integrity Policy value",
    "bootRevisionListInfo": "Boot Revision List Info value",
    "operatingSystemRevListInfo": "Operating System Rev List Info value",
    "healthStatusMismatchInfo": "Health Status Mismatch Info value",
    "healthAttestationSupportedStatus": "Health Attestation Supported Status value"
  },
  "subscriberCarrier": "Subscriber Carrier value",
  "meid": "Meid value",
  "totalStorageSpaceInBytes": 8,
  "freeStorageSpaceInBytes": 7,
  "managedDeviceName": "Managed Device Name value",
  "partnerReportedThreatState": "activated",
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
  "iccid": "Iccid value",
  "udid": "Udid value",
  "notes": "Notes value",
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "enrollmentProfileName": "Enrollment Profile Name value"
}