Список windowsManagedDevices
Пространство имен: microsoft.graph
Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Перечисление свойств и связей объектов windowsManagedDevice .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
| Тип разрешения | Разрешения (в порядке повышения привилегий) |
|---|---|
| Делегированные (рабочая или учебная учетная запись) | DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
| Приложение | DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.Read.All, DeviceManagementManagedDevices.ReadWrite.All |
HTTP-запрос
GET /deviceManagement/managedDevices
GET /deviceManagement/comanagedDevices
GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices
GET /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices
Заголовки запроса
| Заголовок | Значение |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Accept | application/json |
Текст запроса
Не указывайте текст запроса для этого метода.
Отклик
В случае успешного 200 OK выполнения этот метод возвращает код отклика и коллекцию объектов windowsManagedDevice в тексте отклика.
Пример
Запрос
Ниже приведен пример запроса.
GET https://graph.microsoft.com/beta/deviceManagement/managedDevices
Отклик
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 10601
{
"value": [
{
"@odata.type": "#microsoft.graph.windowsManagedDevice",
"id": "97842b67-2b67-9784-672b-8497672b8497",
"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"
}
}
]
}
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по