managedDevice 资源类型
命名空间：microsoft.graph
重要： /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
通过 Intune 托管或预注册的设备
方法
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 设备的唯一标识符。 此属性是只读的。 |
| userId | String | 与设备关联的用户的唯一标识符。 此属性是只读的。 |
| deviceName | String | 设备的名称。 此属性是只读的。 |
| hardwareInformation | hardwareInformation | 设备的硬性详细信息。 包括存储空间、制造商、序列号等信息。默认情况下，此类型的大多数属性都设置为 null/0/false，关联类型的枚举默认值。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 |
| ownerType | ownerType | 设备的所有权。 可能的值为“company”或“personal”。 默认值为未知。 支持$filter运算符“eq”和“or”。 可取值为：unknown、company、personal。 |
| managedDeviceOwnerType | managedDeviceOwnerType | 设备的所有权。 可以是“公司”或“个人”。 可取值为：unknown、company、personal。 |
| deviceActionResults | deviceActionResult 集合 | ComplexType 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 | 设备的平台。 示例：桌面、WindowsRT 等。默认值为未知。 支持$filter运算符“eq”和“or”。 此属性是只读的。 可能的值为：desktop、、windowsRT、holoLensmacwindowsPhonewinEmbeddediPhonewinCEiPadnokiaiPodandroidwinMO6macMDMiSocConsumerunixsurfaceHubandroidForWork、androidEnterprise、chromeOSandroidnGMSwindows10xblackberrypalmlinux、unknown、 。 cloudPC |
| complianceState | complianceState | 设备的符合性状态。 示例：符合性、冲突、错误等。默认值为未知。 支持$filter运算符“eq”和“or”。 此属性是只读的。 可取值为：unknown、compliant、noncompliant、conflict、error、inGracePeriod、configManager。 |
| jailBroken | String | 设备是否越狱或已获取 root 权限。 默认值为空字符串。 支持$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 ID。 此属性是只读的。 |
| easActivationDateTime | DateTimeOffset | 设备的 Exchange ActivationSync 激活时间。 此属性是只读的。 |
| aadRegistered | 布尔值 | 设备是否已注册 Azure Active Directory。 此属性是只读的。 |
| azureADRegistered | Boolean | 设备是否已注册 Azure Active Directory。 此属性是只读的。 |
| deviceEnrollmentType | deviceEnrollmentType | 设备的注册类型。 此属性是只读的。 可能的值为：、、、、deviceEnrollmentManagerwindowsAzureADJoinUsingDeviceAuthwindowsAutoEnrollmentwindowsBulkAzureDomainJoinwindowsBulkUserlessappleBulkWithUserappleBulkWithoutUserwindowsCoManagementwindowsAzureADJoin、appleUserEnrollmentWithServiceAccountappleUserEnrollmentandroidEnterpriseCorporateWorkProfileazureAdJoinUsingAzureVmExtensionandroidEnterpriseDedicatedDeviceandroidAOSPUserOwnedDeviceEnrollmentandroidEnterpriseFullyManaged、androidAOSPUserlessDeviceEnrollment、、appleACMEBasicBYOD、appleACMEDEPUserless、 。 appleACMEDEPUDAModernAuthappleACMEDEPUDASetupAsstLegacyappleACMEDEPUDACompanyPortaluserEnrollmentunknown |
| lostModeState | lostModeState | 指示是启用或禁用丢失模式。 此属性是只读的。 可取值为：disabled、enabled。 |
| activationLockBypassCode | String | 允许绕过托管设备上的激活锁的代码。 在 LIST 调用中作为 managedDevice 实体的一部分返回时，默认值为 Null (非默认属性) 。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 |
| emailAddress | String | Email (与设备关联的用户的) 。 此属性是只读的。 |
| 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。 默认值为空字符串。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 此属性是只读的。 |
| remoteAssistanceSessionErrorDetails | String | 用于在创建远程协助会话对象时识别问题的错误字符串。 此属性是只读的。 |
| isEncrypted | 布尔值 | 设备加密状态。 此属性是只读的。 |
| userPrincipalName | String | 设备用户主体名称。 此属性是只读的。 |
| model | String | 设备的型号。 此属性是只读的。 |
| manufacturer | String | 设备的制造商。 此属性是只读的。 |
| imei | String | Imei。 此属性是只读的。 |
| complianceGracePeriodExpirationDateTime | DateTimeOffset | 设备符合性宽限期到期时的 DateTime。 此属性是只读的。 |
| 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 | 指示帐户和设备正在使用移动威胁防护合作伙伴时设备的威胁状态。 只读。 此属性是只读的。 可取值为：unknown、activated、deactivated、secured、lowSeverity、mediumSeverity、highSeverity、unresponsive、compromised、misconfigured。 |
| retireAfterDateTime | DateTimeOffset | 指示设备因计划操作而自动停用的时间。 此属性是只读的。 |
| usersLoggedOn | loggedOnUser 集合 | 指示设备的最后一个登录用户。 此属性是只读的。 |
| preferMdmOverGroupPolicyAppliedDateTime | DateTimeOffset | 报告设置了 preferMdmOverGroupPolicy 设置的 DateTime。 如果存在冲突，Intune MDM 设置将覆盖组策略设置。 只读。 此属性是只读的。 |
| autopilotEnrolled | 布尔值 | 报告托管设备是否通过自动试点注册。 此属性是只读的。 |
| requireUserEnrollmentApproval | 布尔值 | 报告托管 iOS 设备是否为用户审批注册。 此属性是只读的。 |
| managementCertificateExpirationDate | DateTimeOffset | 报告设备管理证书到期日期。 此属性是只读的。 |
| iccid | String | 集成电路卡标识符，它是 SIM 卡的唯一标识号。 默认值为空字符串。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 |
| udid | String | iOS 和 macOS 设备的唯一设备标识符。 默认值为空字符串。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 |
| roleScopeTagIds | 字符串集合 | 此设备实例的范围标记 ID 列表。 |
| windowsActiveMalwareCount | Int32 | 此 Windows 设备的活动恶意软件计数。 默认值为 0。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 此属性是只读的。 |
| windowsRemediatedMalwareCount | Int32 | 此 Windows 设备的已修正恶意软件计数。 默认值为 0。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 此属性是只读的。 |
| notes | String | IT 管理员创建的设备上的说明。默认值为 null。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 |
| configurationManagerClientHealthState | configurationManagerClientHealthState | Configuration Manager 客户端运行状况状态，仅对 MDM/ConfigMgr 代理管理的设备有效 |
| configurationManagerClientInformation | configurationManagerClientInformation | Configuration Manager 客户端信息，仅适用于由 ConfigMgr 代理托管、二元托管或三管理的设备 |
| ethernetMacAddress | String | 指示设备的以太网 MAC 地址。 作为 managedDevice 实体的一部分返回时，默认值为 Null (非默认属性) 。 需要具有选择查询选项的单个 get 调用才能检索实际值。 示例：deviceManagement/managedDevices ({managedDeviceId}) ？$select=ethernetMacAddress 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 |
| physicalMemoryInBytes | Int64 | 总内存（以字节为单位）。 默认值为 0。 若要检索实际值，需要使用设备 ID 进行 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，它们采用 () 格式。 对于 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 设备的属性列表。 默认值为空列表。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 |
| enrollmentProfileName | String | 分配给设备的注册配置文件的名称。 默认值为空字符串，指示未执行任何注册配置文件。 此属性是只读的。 |
| bootstrapTokenEscrowed | 布尔值 | 报告托管设备是否具有托管的启动令牌。 这仅适用于 macOS 设备。 若要获取，请在 select 子句中包含 BootstrapTokenEscrowed，并使用设备 ID 进行查询。如果为 FALSE，则不会托管启动令牌。 如果为 TRUE，则设备已使用Intune托管启动令牌。 此属性是只读的。 |
| deviceFirmwareConfigurationInterfaceManaged | 布尔值 | 指示设备是否受 DFCI 管理。 如果为 TRUE，则设备受 DFCI 管理。 如果为 FALSE，则设备不受 DFCI 管理。 默认值为 FALSE。 |
| deviceIdentityAttestationDetail | deviceIdentityAttestationDetail | 指示托管设备的证明状态。 以哪种方式。 默认值：未知。 |
关系
| 关系 | 类型 | 说明 |
|---|---|---|
| detectedApps | detectedApp 集合 | 设备上当前安装的所有应用程序 |
| deviceCategory | deviceCategory | 设备类别 |
| windowsProtectionState | windowsProtectionState | 设备保护状态。 此属性是只读的。 |
| users | user 集合 | 与托管设备关联的主用户。 |
| logCollectionRequests | deviceLogCollectionResponse 集合 | 日志收集请求列表 |
| deviceHealthScriptStates | deviceHealthScriptPolicyState 集合 | 为此设备运行的设备运行状况脚本的结果。 默认值为空列表。 此属性是只读的。 |
JSON 表示形式
下面是资源的 JSON 表示形式。
{
"@odata.type": "#microsoft.graph.managedDevice",
"id": "String (identifier)",
"userId": "String",
"deviceName": "String",
"hardwareInformation": {
"@odata.type": "microsoft.graph.hardwareInformation",
"serialNumber": "String",
"totalStorageSpace": 1024,
"freeStorageSpace": 1024,
"imei": "String",
"meid": "String",
"manufacturer": "String",
"model": "String",
"phoneNumber": "String",
"subscriberCarrier": "String",
"cellularTechnology": "String",
"wifiMac": "String",
"operatingSystemLanguage": "String",
"isSupervised": true,
"isEncrypted": true,
"batterySerialNumber": "String",
"batteryHealthPercentage": 1024,
"batteryChargeCycles": 1024,
"isSharedDevice": true,
"sharedDeviceCachedUsers": [
{
"@odata.type": "microsoft.graph.sharedAppleDeviceUser",
"userPrincipalName": "String",
"dataToSync": true,
"dataQuota": 1024,
"dataUsed": 1024
}
],
"tpmSpecificationVersion": "String",
"operatingSystemEdition": "String",
"deviceFullQualifiedDomainName": "String",
"deviceGuardVirtualizationBasedSecurityHardwareRequirementState": "String",
"deviceGuardVirtualizationBasedSecurityState": "String",
"deviceGuardLocalSystemAuthorityCredentialGuardState": "String",
"osBuildNumber": "String",
"operatingSystemProductType": 1024,
"ipAddressV4": "String",
"subnetAddress": "String",
"esimIdentifier": "String",
"systemManagementBIOSVersion": "String",
"tpmManufacturer": "String",
"tpmVersion": "String",
"wiredIPv4Addresses": [
"String"
],
"batteryLevelPercentage": "4.2",
"residentUsersCount": 1024,
"productName": "String",
"deviceLicensingStatus": "String",
"deviceLicensingLastErrorCode": 1024,
"deviceLicensingLastErrorDescription": "String"
},
"ownerType": "String",
"managedDeviceOwnerType": "String",
"deviceActionResults": [
{
"@odata.type": "microsoft.graph.deviceActionResult",
"actionName": "String",
"actionState": "String",
"startDateTime": "String (timestamp)",
"lastUpdatedDateTime": "String (timestamp)"
}
],
"managementState": "String",
"enrolledDateTime": "String (timestamp)",
"lastSyncDateTime": "String (timestamp)",
"chassisType": "String",
"operatingSystem": "String",
"deviceType": "String",
"complianceState": "String",
"jailBroken": "String",
"managementAgent": "String",
"osVersion": "String",
"easActivated": true,
"easDeviceId": "String",
"easActivationDateTime": "String (timestamp)",
"aadRegistered": true,
"azureADRegistered": true,
"deviceEnrollmentType": "String",
"lostModeState": "String",
"activationLockBypassCode": "String",
"emailAddress": "String",
"azureActiveDirectoryDeviceId": "String",
"azureADDeviceId": "String",
"deviceRegistrationState": "String",
"deviceCategoryDisplayName": "String",
"isSupervised": true,
"exchangeLastSuccessfulSyncDateTime": "String (timestamp)",
"exchangeAccessState": "String",
"exchangeAccessStateReason": "String",
"remoteAssistanceSessionUrl": "String",
"remoteAssistanceSessionErrorDetails": "String",
"isEncrypted": true,
"userPrincipalName": "String",
"model": "String",
"manufacturer": "String",
"imei": "String",
"complianceGracePeriodExpirationDateTime": "String (timestamp)",
"serialNumber": "String",
"phoneNumber": "String",
"androidSecurityPatchLevel": "String",
"userDisplayName": "String",
"configurationManagerClientEnabledFeatures": {
"@odata.type": "microsoft.graph.configurationManagerClientEnabledFeatures",
"inventory": true,
"modernApps": true,
"resourceAccess": true,
"deviceConfiguration": true,
"compliancePolicy": true,
"windowsUpdateForBusiness": true,
"endpointProtection": true,
"officeApps": true
},
"wiFiMacAddress": "String",
"deviceHealthAttestationState": {
"@odata.type": "microsoft.graph.deviceHealthAttestationState",
"lastUpdateDateTime": "String",
"contentNamespaceUrl": "String",
"deviceHealthAttestationStatus": "String",
"contentVersion": "String",
"issuedDateTime": "String (timestamp)",
"attestationIdentityKey": "String",
"resetCount": 1024,
"restartCount": 1024,
"dataExcutionPolicy": "String",
"bitLockerStatus": "String",
"bootManagerVersion": "String",
"codeIntegrityCheckVersion": "String",
"secureBoot": "String",
"bootDebugging": "String",
"operatingSystemKernelDebugging": "String",
"codeIntegrity": "String",
"testSigning": "String",
"safeMode": "String",
"windowsPE": "String",
"earlyLaunchAntiMalwareDriverProtection": "String",
"virtualSecureMode": "String",
"pcrHashAlgorithm": "String",
"bootAppSecurityVersion": "String",
"bootManagerSecurityVersion": "String",
"tpmVersion": "String",
"pcr0": "String",
"secureBootConfigurationPolicyFingerPrint": "String",
"codeIntegrityPolicy": "String",
"bootRevisionListInfo": "String",
"operatingSystemRevListInfo": "String",
"healthStatusMismatchInfo": "String",
"healthAttestationSupportedStatus": "String",
"memoryIntegrityProtection": "String",
"memoryAccessProtection": "String",
"virtualizationBasedSecurity": "String",
"firmwareProtection": "String",
"systemManagementMode": "String",
"securedCorePC": "String"
},
"subscriberCarrier": "String",
"meid": "String",
"totalStorageSpaceInBytes": 1024,
"freeStorageSpaceInBytes": 1024,
"managedDeviceName": "String",
"partnerReportedThreatState": "String",
"retireAfterDateTime": "String (timestamp)",
"usersLoggedOn": [
{
"@odata.type": "microsoft.graph.loggedOnUser",
"userId": "String",
"lastLogOnDateTime": "String (timestamp)"
}
],
"preferMdmOverGroupPolicyAppliedDateTime": "String (timestamp)",
"autopilotEnrolled": true,
"requireUserEnrollmentApproval": true,
"managementCertificateExpirationDate": "String (timestamp)",
"iccid": "String",
"udid": "String",
"roleScopeTagIds": [
"String"
],
"windowsActiveMalwareCount": 1024,
"windowsRemediatedMalwareCount": 1024,
"notes": "String",
"configurationManagerClientHealthState": {
"@odata.type": "microsoft.graph.configurationManagerClientHealthState",
"state": "String",
"errorCode": 1024,
"lastSyncDateTime": "String (timestamp)"
},
"configurationManagerClientInformation": {
"@odata.type": "microsoft.graph.configurationManagerClientInformation",
"clientIdentifier": "String",
"isBlocked": true,
"clientVersion": "String"
},
"ethernetMacAddress": "String",
"physicalMemoryInBytes": 1024,
"processorArchitecture": "String",
"specificationVersion": "String",
"joinType": "String",
"skuFamily": "String",
"securityPatchLevel": "String",
"skuNumber": 1024,
"managementFeatures": "String",
"chromeOSDeviceInfo": [
{
"@odata.type": "microsoft.graph.chromeOSDeviceProperty",
"name": "String",
"value": "String",
"valueType": "String",
"updatable": true
}
],
"enrollmentProfileName": "String",
"bootstrapTokenEscrowed": true,
"deviceFirmwareConfigurationInterfaceManaged": true,
"deviceIdentityAttestationDetail": {
"@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
"deviceIdentityAttestationStatus": "String"
}
}
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈