Обновление managedDevice
Пространство имен: microsoft.graph
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Обновление свойств объекта managedDevice.
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
| Тип разрешения | Разрешения (в порядке повышения привилегий) |
|---|---|
| Делегированные (рабочая или учебная учетная запись) | DeviceManagementManagedDevices.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
| Приложение | DeviceManagementManagedDevices.ReadWrite.All |
HTTP-запрос
PATCH /deviceManagement/managedDevices/{managedDeviceId}
PATCH /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}
PATCH /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/users/{userId}/managedDevices/{managedDeviceId}
Заголовки запроса
| Заголовок | Значение |
|---|---|
| Авторизация | 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. $Поиск не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
| 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 | Имя профиля регистрации, назначенного устройству. Значение по умолчанию — пустая строка, указывающая, что профиль регистрации не был настроен. Это свойство доступно только для чтения. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK и обновленный объект managedDevice в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
PATCH https://graph.microsoft.com/v1.0/deviceManagement/managedDevices/{managedDeviceId}
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 200 OK
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"
}
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по