Обновление managedDevice
Пространство имен: microsoft.graph
Важный: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Обновление свойств объекта managedDevice.
Этот API доступен в следующих национальных облачных развертываниях.
Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения | Разрешения (в порядке повышения привилегий) |
---|---|
Делегированные (рабочая или учебная учетная запись) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All |
Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
Приложение | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All |
HTTP-запрос
PATCH /deviceManagement/managedDevices/{managedDeviceId}
PATCH /deviceManagement/comanagedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates/{deviceComplianceScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}
Заголовки запроса
Заголовок | Значение |
---|---|
Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
Accept | application/json |
Текст запроса
В теле запроса добавьте представление объекта managedDevice в формате JSON.
В приведенной ниже таблице показаны свойства, которые необходимо указывать при создании объекта managedDevice.
Свойство | Тип | Описание |
---|---|---|
id | String | Уникальный идентификатор устройства. Это свойство доступно только для чтения. |
userId | String | Уникальный идентификатор пользователя, связанного с устройством. Это свойство доступно только для чтения. |
deviceName | String | Имя устройства. Это свойство доступно только для чтения. |
hardwareInformation | hardwareInformation | Подробные сведения об устройстве. Включает такие сведения, как дисковое пространство, производитель, серийный номер и т. д. По умолчанию для большинства свойств этого типа задано значение null/0/false, а для связанных типов — перечисление по умолчанию. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Search не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
ownerType | ownerType | Владение устройством. Возможные значения: "company" или "personal". Значение по умолчанию неизвестно. Поддерживает операторы $filter eq и or. Возможные значения: unknown , company , personal . |
managedDeviceOwnerType | managedDeviceOwnerType. | Владение устройством. Может быть "корпоративным" или "личным". Возможные значения: unknown , company , personal . |
deviceActionResults | Коллекция deviceActionResult | Список объектов deviceActionResult сложного типа. Это свойство доступно только для чтения. |
managementState | managementState | Состояние управления устройством. Примеры: Managed, RetirePending и т. д. По умолчанию используется управление. Поддерживает операторы $filter eq и or. Это свойство доступно только для чтения. Возможные значения: managed , retirePending , retireFailed , wipePending , wipeFailed , unhealthy , deletePending , retireIssued , wipeIssued , wipeCanceled , retireCanceled , discovered . |
enrolledDateTime | DateTimeOffset | Время регистрации устройства. Поддерживает операторы $filter "lt" и "gt". Это свойство доступно только для чтения. |
lastSyncDateTime | DateTimeOffset | Дата и время последней успешной синхронизации устройства с Intune. Поддерживает операторы $filter "lt" и "gt". Это свойство доступно только для чтения. |
chassisType | chassisType | Тип корпуса устройства. Это свойство доступно только для чтения. Возможные значения: unknown , desktop , laptop , worksWorkstation , enterpriseServer , phone , tablet , mobileOther , mobileUnknown . |
operatingSystem | String | Операционная система устройства. Windows, iOS и т. д. Это свойство доступно только для чтения. |
deviceType | deviceType | Платформа устройства. Примеры: Desktop, WindowsRT и т. д. Значение по умолчанию неизвестно. Поддерживает операторы $filter eq и or. Это свойство доступно только для чтения. Возможные значения: desktop , windowsRT , , winMO6 , nokia , mac windowsPhone , winCE , winEmbedded , iPhone , iPad macMDM holoLens iSocConsumer unix androidForWork android iPod androidEnterprise surfaceHub windows10x , androidnGMS , chromeOS , linux , , blackberry , palm , . cloudPC unknown |
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 , microsoft365ManagedMdm , msSense , intuneAosp , google , unknownFutureValue . |
osVersion | String | Версия операционной системы устройства. Это свойство доступно только для чтения. |
easActivated | Boolean | Указывает, активировано ли устройство в Exchange ActiveSync. Это свойство доступно только для чтения. |
easDeviceId | String | Идентификатор устройства в Exchange ActiveSync. Это свойство доступно только для чтения. |
easActivationDateTime | DateTimeOffset | Время активации устройства в Exchange ActivationSync. Это свойство доступно только для чтения. |
aadRegistered | Логический | Указывает, зарегистрировано ли устройство в Azure Active Directory. Это свойство доступно только для чтения. |
azureADRegistered | Boolean | Указывает, зарегистрировано ли устройство в Azure Active Directory. Это свойство доступно только для чтения. |
deviceEnrollmentType | deviceEnrollmentType | Тип регистрации устройства. Это свойство доступно только для чтения. Возможные значения: unknown , , userEnrollment , deviceEnrollmentManager , appleBulkWithoutUser appleBulkWithUser , , windowsAzureADJoin , windowsAutoEnrollment windowsBulkUserless , windowsBulkAzureDomainJoin , windowsCoManagement windowsAzureADJoinUsingDeviceAuth appleUserEnrollment appleUserEnrollmentWithServiceAccount , azureAdJoinUsingAzureVmExtension , androidEnterpriseDedicatedDevice , androidEnterpriseFullyManaged , , androidEnterpriseCorporateWorkProfile , appleACMEBasicBYOD , appleACMEDEPUserless , , appleACMEDEPUDACompanyPortal , . appleACMEDEPUDAModernAuth appleACMEDEPUDASetupAsstLegacy |
lostModeState | lostModeState | Указывает, включен или отключен режим пропажи. Это свойство доступно только для чтения. Возможные значения: disabled , enabled . |
activationLockBypassCode | String | Код, позволяющий обойти блокировку активации на управляемом устройстве. Значение по умолчанию — NULL (свойство, отличное от значения по умолчанию) для этого свойства, если оно возвращается в составе сущности managedDevice в вызове LIST. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Search не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
emailAddress | String | Сообщения электронной почты для пользователя, связанного с устройством. Это свойство доступно только для чтения. |
azureActiveDirectoryDeviceId | String | Уникальный идентификатор устройства Azure Active Directory. Только для чтения. Это свойство доступно только для чтения. |
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 . |
retireAfterDateTime | DateTimeOffset | Указывает время после того, как устройство будет автоматически выведено из эксплуатации из-за запланированного действия. Это свойство доступно только для чтения. |
usersLoggedOn | коллекция loggedOnUser | Указывает последних пользователей устройства, выполнившего вход. Это свойство доступно только для чтения. |
preferMdmOverGroupPolicyAppliedDateTime | DateTimeOffset | Сообщает, что параметр preferMdmOverGroupPolicy задан в dateTime. Если они заданы, параметры MDM Intune переопределяют параметры групповой политики в случае конфликта. Только для чтения. Это свойство доступно только для чтения. |
autopilotEnrolled | Логический | Сообщает, зарегистрировано ли управляемое устройство с помощью автоматического пилотного развертывания. Это свойство доступно только для чтения. |
requireUserEnrollmentApproval | Логический | Сообщает, что управляемое устройство iOS зарегистрировано для утверждения пользователем. Это свойство доступно только для чтения. |
managementCertificateExpirationDate | DateTimeOffset | Сообщает об истечении срока действия сертификата управления устройствами. Это свойство доступно только для чтения. |
iccid | String | Идентификатор карты интегральной схемы. Это уникальный идентификационный номер SIM-карты. По умолчанию используется пустая строка. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Search не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
udid | String | Уникальный идентификатор устройства для устройств iOS и macOS. По умолчанию используется пустая строка. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Search не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
roleScopeTagIds | Коллекция строк | Список идентификаторов тегов области для этого экземпляра устройства. |
windowsActiveMalwareCount | Int32 | Количество активных вредоносных программ для этого устройства Windows. Значение по умолчанию — 0. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Это свойство доступно только для чтения. |
windowsRemediatedMalwareCount | Int32 | Количество исправленных вредоносных программ для этого устройства Windows. Значение по умолчанию — 0. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Это свойство доступно только для чтения. |
notes | String | Заметки на устройстве, созданном ИТ-администратором. Значение по умолчанию равно NULL. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. $Search не поддерживается. |
configurationManagerClientHealthState | configurationManagerClientHealthState | Состояние работоспособности клиента Configuration Manager, допустимое только для устройств, управляемых агентом MDM/ConfigMgr |
configurationManagerClientInformation | configurationManagerClientInformation | Сведения о клиенте Configuration Manager, допустимые только для устройств, управляемых, управляемых дуэлем или трех управляемых агентом ConfigMgr |
ethernetMacAddress | String | Указывает MAC-адрес Ethernet устройства. Значение по умолчанию равно NULL (свойство, отличное от по умолчанию) для этого свойства, если оно возвращается в составе объекта managedDevice. Для получения фактических значений требуется отдельный вызов get с параметрами выбора запроса. Пример: deviceManagement/managedDevices({managedDeviceId})?$select=ethernetMacAddress Поддерживает: $select. $Search не поддерживается. Только для чтения. Это свойство доступно только для чтения. |
physicalMemoryInBytes | Int64 | Общий объем памяти в байтах. Значение по умолчанию — 0. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. Поддерживает: $select. Только для чтения. Это свойство доступно только для чтения. |
processorArchitecture | managedDeviceArchitecture | Архитектура процессора. Это свойство доступно только для чтения. Возможные значения: unknown , x86 , x64 , arm , arM64 . |
specificationVersion | String | Версия спецификации. Это свойство доступно только для чтения. |
joinType | joinType | Тип присоединения устройства. Возможные значения: unknown , azureADJoined , azureADRegistered , hybridAzureADJoined . |
skuFamily | String | Семейство номеров SKU устройств |
securityPatchLevel | String | Это указывает на уровень исправлений для системы безопасности операционной системы. Эти специальные обновления содержат важные исправления безопасности. Для iOS/MacOS они имеют формат (a). Для android его в формате 2017-08-07. Это свойство доступно только для чтения. |
skuNumber | Int32 | Номер номера SKU устройства см. также: https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo. Допустимые значения от 0 до 2147483647. Это свойство доступно только для чтения. |
managementFeatures | managedDeviceManagementFeatures | Функции управления устройствами. Возможные значения: none , microsoftManagedDesktop . |
chromeOSDeviceInfo | Коллекция chromeOSDeviceProperty | Список свойств устройства ChromeOS. По умолчанию используется пустой список. Чтобы получить фактические значения, необходимо выполнить вызов GET с идентификатором устройства и включенным в параметр select. |
enrollmentProfileName | String | Имя профиля регистрации, назначенного устройству. Значение по умолчанию — пустая строка, указывающая, что профиль регистрации не был настроен. Это свойство доступно только для чтения. |
bootstrapTokenEscrowed | Логический | Сообщает, есть ли у управляемого устройства депонирован маркер начальной загрузки. Это только для устройств macOS. Чтобы получить, включите BootstrapTokenEscrowed в предложение select и запрос с идентификатором устройства. Если значение FALSE, маркер начальной загрузки не депонируется. Если значение TRUE, устройство депонировало маркер начальной загрузки с помощью Intune. Это свойство доступно только для чтения. |
deviceFirmwareConfigurationInterfaceManaged | Логический | Указывает, управляется ли устройство DFCI. При значении TRUE устройство управляется DFCI. При значении FALSE устройство не управляется DFCI. Значение по умолчанию — FALSE. |
deviceIdentityAttestationDetail | deviceIdentityAttestationDetail | Указывает состояние аттестации управляемого устройства. И каким образом. По умолчанию: неизвестно. |
Отклик
В случае успешного выполнения этот метод возвращает код отклика 200 OK
и обновленный объект managedDevice в теле отклика.
Пример
Запрос
Ниже приведен пример запроса.
PATCH https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId}
Content-type: application/json
Content-length: 9620
{
"@odata.type": "#microsoft.graph.managedDevice",
"userId": "User Id value",
"deviceName": "Device Name value",
"hardwareInformation": {
"@odata.type": "microsoft.graph.hardwareInformation",
"serialNumber": "Serial Number value",
"totalStorageSpace": 1,
"freeStorageSpace": 0,
"imei": "Imei value",
"meid": "Meid value",
"manufacturer": "Manufacturer value",
"model": "Model value",
"phoneNumber": "Phone Number value",
"subscriberCarrier": "Subscriber Carrier value",
"cellularTechnology": "Cellular Technology value",
"wifiMac": "Wifi Mac value",
"operatingSystemLanguage": "Operating System Language value",
"isSupervised": true,
"isEncrypted": true,
"batterySerialNumber": "Battery Serial Number value",
"batteryHealthPercentage": 7,
"batteryChargeCycles": 3,
"isSharedDevice": true,
"sharedDeviceCachedUsers": [
{
"@odata.type": "microsoft.graph.sharedAppleDeviceUser",
"userPrincipalName": "User Principal Name value",
"dataToSync": true,
"dataQuota": 9,
"dataUsed": 8
}
],
"tpmSpecificationVersion": "Tpm Specification Version value",
"operatingSystemEdition": "Operating System Edition value",
"deviceFullQualifiedDomainName": "Device Full Qualified Domain Name value",
"deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "secureBootRequired",
"deviceGuardVirtualizationBasedSecurityState": "rebootRequired",
"deviceGuardLocalSystemAuthorityCredentialGuardState": "rebootRequired",
"osBuildNumber": "Os Build Number value",
"operatingSystemProductType": 10,
"ipAddressV4": "Ip Address V4 value",
"subnetAddress": "Subnet Address value",
"esimIdentifier": "Esim Identifier value",
"systemManagementBIOSVersion": "System Management BIOSVersion value",
"tpmManufacturer": "Tpm Manufacturer value",
"tpmVersion": "Tpm Version value",
"wiredIPv4Addresses": [
"Wired IPv4Addresses value"
],
"batteryLevelPercentage": 7.333333333333333,
"residentUsersCount": 2,
"productName": "Product Name value",
"deviceLicensingStatus": "licenseRefreshPending",
"deviceLicensingLastErrorCode": 12,
"deviceLicensingLastErrorDescription": "Device Licensing Last Error Description value"
},
"ownerType": "company",
"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"
}
],
"managementState": "retirePending",
"enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"chassisType": "desktop",
"operatingSystem": "Operating System value",
"deviceType": "windowsRT",
"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",
"aadRegistered": true,
"azureADRegistered": true,
"deviceEnrollmentType": "userEnrollment",
"lostModeState": "enabled",
"activationLockBypassCode": "Activation Lock Bypass Code value",
"emailAddress": "Email Address value",
"azureActiveDirectoryDeviceId": "Azure Active Directory Device Id 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,
"endpointProtection": true,
"officeApps": 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",
"memoryIntegrityProtection": "enabled",
"memoryAccessProtection": "enabled",
"virtualizationBasedSecurity": "enabled",
"firmwareProtection": "systemGuardSecureLaunch",
"systemManagementMode": "level1",
"securedCorePC": "enabled"
},
"subscriberCarrier": "Subscriber Carrier value",
"meid": "Meid value",
"totalStorageSpaceInBytes": 8,
"freeStorageSpaceInBytes": 7,
"managedDeviceName": "Managed Device Name value",
"partnerReportedThreatState": "activated",
"retireAfterDateTime": "2016-12-31T23:57:37.576134-08:00",
"usersLoggedOn": [
{
"@odata.type": "microsoft.graph.loggedOnUser",
"userId": "User Id value",
"lastLogOnDateTime": "2016-12-31T23:58:37.4262708-08:00"
}
],
"preferMdmOverGroupPolicyAppliedDateTime": "2016-12-31T23:57:34.4649887-08:00",
"autopilotEnrolled": true,
"requireUserEnrollmentApproval": true,
"managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
"iccid": "Iccid value",
"udid": "Udid value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"windowsActiveMalwareCount": 9,
"windowsRemediatedMalwareCount": 13,
"notes": "Notes value",
"configurationManagerClientHealthState": {
"@odata.type": "microsoft.graph.configurationManagerClientHealthState",
"state": "installed",
"errorCode": 9,
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
},
"configurationManagerClientInformation": {
"@odata.type": "microsoft.graph.configurationManagerClientInformation",
"clientIdentifier": "Client Identifier value",
"isBlocked": true,
"clientVersion": "Client Version value"
},
"ethernetMacAddress": "Ethernet Mac Address value",
"physicalMemoryInBytes": 5,
"processorArchitecture": "x86",
"specificationVersion": "Specification Version value",
"joinType": "azureADJoined",
"skuFamily": "Sku Family value",
"securityPatchLevel": "Security Patch Level value",
"skuNumber": 9,
"managementFeatures": "microsoftManagedDesktop",
"chromeOSDeviceInfo": [
{
"@odata.type": "microsoft.graph.chromeOSDeviceProperty",
"name": "Name value",
"value": "Value value",
"valueType": "Value Type value",
"updatable": true
}
],
"enrollmentProfileName": "Enrollment Profile Name value",
"bootstrapTokenEscrowed": true,
"deviceFirmwareConfigurationInterfaceManaged": true,
"deviceIdentityAttestationDetail": {
"@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
"deviceIdentityAttestationStatus": "trusted"
}
}
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 9669
{
"@odata.type": "#microsoft.graph.managedDevice",
"id": "705c034c-034c-705c-4c03-5c704c035c70",
"userId": "User Id value",
"deviceName": "Device Name value",
"hardwareInformation": {
"@odata.type": "microsoft.graph.hardwareInformation",
"serialNumber": "Serial Number value",
"totalStorageSpace": 1,
"freeStorageSpace": 0,
"imei": "Imei value",
"meid": "Meid value",
"manufacturer": "Manufacturer value",
"model": "Model value",
"phoneNumber": "Phone Number value",
"subscriberCarrier": "Subscriber Carrier value",
"cellularTechnology": "Cellular Technology value",
"wifiMac": "Wifi Mac value",
"operatingSystemLanguage": "Operating System Language value",
"isSupervised": true,
"isEncrypted": true,
"batterySerialNumber": "Battery Serial Number value",
"batteryHealthPercentage": 7,
"batteryChargeCycles": 3,
"isSharedDevice": true,
"sharedDeviceCachedUsers": [
{
"@odata.type": "microsoft.graph.sharedAppleDeviceUser",
"userPrincipalName": "User Principal Name value",
"dataToSync": true,
"dataQuota": 9,
"dataUsed": 8
}
],
"tpmSpecificationVersion": "Tpm Specification Version value",
"operatingSystemEdition": "Operating System Edition value",
"deviceFullQualifiedDomainName": "Device Full Qualified Domain Name value",
"deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "secureBootRequired",
"deviceGuardVirtualizationBasedSecurityState": "rebootRequired",
"deviceGuardLocalSystemAuthorityCredentialGuardState": "rebootRequired",
"osBuildNumber": "Os Build Number value",
"operatingSystemProductType": 10,
"ipAddressV4": "Ip Address V4 value",
"subnetAddress": "Subnet Address value",
"esimIdentifier": "Esim Identifier value",
"systemManagementBIOSVersion": "System Management BIOSVersion value",
"tpmManufacturer": "Tpm Manufacturer value",
"tpmVersion": "Tpm Version value",
"wiredIPv4Addresses": [
"Wired IPv4Addresses value"
],
"batteryLevelPercentage": 7.333333333333333,
"residentUsersCount": 2,
"productName": "Product Name value",
"deviceLicensingStatus": "licenseRefreshPending",
"deviceLicensingLastErrorCode": 12,
"deviceLicensingLastErrorDescription": "Device Licensing Last Error Description value"
},
"ownerType": "company",
"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"
}
],
"managementState": "retirePending",
"enrolledDateTime": "2016-12-31T23:59:43.797191-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"chassisType": "desktop",
"operatingSystem": "Operating System value",
"deviceType": "windowsRT",
"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",
"aadRegistered": true,
"azureADRegistered": true,
"deviceEnrollmentType": "userEnrollment",
"lostModeState": "enabled",
"activationLockBypassCode": "Activation Lock Bypass Code value",
"emailAddress": "Email Address value",
"azureActiveDirectoryDeviceId": "Azure Active Directory Device Id 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,
"endpointProtection": true,
"officeApps": 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",
"memoryIntegrityProtection": "enabled",
"memoryAccessProtection": "enabled",
"virtualizationBasedSecurity": "enabled",
"firmwareProtection": "systemGuardSecureLaunch",
"systemManagementMode": "level1",
"securedCorePC": "enabled"
},
"subscriberCarrier": "Subscriber Carrier value",
"meid": "Meid value",
"totalStorageSpaceInBytes": 8,
"freeStorageSpaceInBytes": 7,
"managedDeviceName": "Managed Device Name value",
"partnerReportedThreatState": "activated",
"retireAfterDateTime": "2016-12-31T23:57:37.576134-08:00",
"usersLoggedOn": [
{
"@odata.type": "microsoft.graph.loggedOnUser",
"userId": "User Id value",
"lastLogOnDateTime": "2016-12-31T23:58:37.4262708-08:00"
}
],
"preferMdmOverGroupPolicyAppliedDateTime": "2016-12-31T23:57:34.4649887-08:00",
"autopilotEnrolled": true,
"requireUserEnrollmentApproval": true,
"managementCertificateExpirationDate": "2016-12-31T23:57:59.9789653-08:00",
"iccid": "Iccid value",
"udid": "Udid value",
"roleScopeTagIds": [
"Role Scope Tag Ids value"
],
"windowsActiveMalwareCount": 9,
"windowsRemediatedMalwareCount": 13,
"notes": "Notes value",
"configurationManagerClientHealthState": {
"@odata.type": "microsoft.graph.configurationManagerClientHealthState",
"state": "installed",
"errorCode": 9,
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00"
},
"configurationManagerClientInformation": {
"@odata.type": "microsoft.graph.configurationManagerClientInformation",
"clientIdentifier": "Client Identifier value",
"isBlocked": true,
"clientVersion": "Client Version value"
},
"ethernetMacAddress": "Ethernet Mac Address value",
"physicalMemoryInBytes": 5,
"processorArchitecture": "x86",
"specificationVersion": "Specification Version value",
"joinType": "azureADJoined",
"skuFamily": "Sku Family value",
"securityPatchLevel": "Security Patch Level value",
"skuNumber": 9,
"managementFeatures": "microsoftManagedDesktop",
"chromeOSDeviceInfo": [
{
"@odata.type": "microsoft.graph.chromeOSDeviceProperty",
"name": "Name value",
"value": "Value value",
"valueType": "Value Type value",
"updatable": true
}
],
"enrollmentProfileName": "Enrollment Profile Name value",
"bootstrapTokenEscrowed": true,
"deviceFirmwareConfigurationInterfaceManaged": true,
"deviceIdentityAttestationDetail": {
"@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
"deviceIdentityAttestationStatus": "trusted"
}
}