通过

managedDevice 资源类型

命名空间：microsoft.graph

注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。

通过 Intune 托管或预注册的设备

方法

方法 返回类型 说明
List managedDevices managedDevice 集合 列出 managedDevice 对象的属性和关系。
Get managedDevice managedDevice 读取 managedDevice 对象的属性和关系。
Create managedDevice managedDevice 创建新的 managedDevice 对象。
Delete managedDevice 无 删除 managedDevice。
Update managedDevice managedDevice 更新 managedDevice 对象的属性。
停用作 None 停用设备
擦除操作 None 擦除设备
resetPasscode 操作 无 重置密码
remoteLock 操作 无 远程锁定
requestRemoteAssistance 操作 无 请求远程协助
disableLostMode 操作 无 禁用丢失模式
locateDevice 操作 无 查找设备
bypassActivationLock 操作 无 跳过激活锁
rebootNow 操作 无 重新启动设备
shutDown 操作 无 关闭设备
recoverPasscode 操作 无 恢复密码
cleanWindowsDevice 操作 无 干净的 Windows 设备
logoutSharedAppleDeviceActiveUser 操作 无 注销共享 Apple 设备活动用户
deleteUserFromSharedAppleDevice 操作 无 从共享 Apple 设备中删除用户
syncDevice 操作 None
windowsDefenderScan 操作 None
windowsDefenderUpdateSignatures 操作 None
updateWindowsDeviceAccount 操作 None

属性

属性 类型 说明
id String 设备的唯一标识符。 此属性是只读的。
userId String 与设备关联的用户的唯一标识符。 此属性是只读的。
deviceName String 设备的名称。 此属性是只读的。
managedDeviceOwnerType managedDeviceOwnerType 设备的所有权。 可以是“公司”或“个人”。 可取值为：unknown、company、personal。
deviceActionResults deviceActionResult 集合 ComplexType 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 设备是否越狱或已获取 root 权限。 默认值为空字符串。 支持$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 ID。 此属性是只读的。
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 允许绕过托管设备上的激活锁的代码。 在 LIST 调用中作为 managedDevice 实体的一部分返回时，默认值为 Null (非默认属性) 。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持$Search。 只读。 此属性是只读的。
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。 默认值为空字符串。 若要检索实际值，需要使用设备 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。
requireUserEnrollmentApproval 布尔值 报告托管 iOS 设备是否为用户审批注册。 此属性是只读的。
managementCertificateExpirationDate DateTimeOffset 报告设备管理证书到期日期。 此属性是只读的。
iccid String 集成电路卡标识符，它是 SIM 卡的唯一标识号。 默认值为空字符串。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持$Search。 只读。 此属性是只读的。
udid String iOS 和 macOS 设备的唯一设备标识符。 默认值为空字符串。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持$Search。 只读。 此属性是只读的。
notes String IT 管理员创建的设备上的说明。默认值为 null。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持$Search。
ethernetMacAddress String 指示设备的以太网 MAC 地址。 作为 managedDevice 实体的一部分返回时，默认值为 Null (非默认属性) 。 需要具有选择查询选项的单个 get 调用才能检索实际值。 示例：deviceManagement/managedDevices ({managedDeviceId}) ？$select=ethernetMacAddress 支持：$select。 不支持$Search。 只读。 此属性是只读的。
physicalMemoryInBytes Int64 总内存（以字节为单位）。 默认值为 0。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 只读。 此属性是只读的。
enrollmentProfileName String 分配给设备的注册配置文件的名称。 默认值为空字符串，指示未执行任何注册配置文件。 此属性是只读的。

关系

关系 类型 说明
deviceCategory deviceCategory 设备类别
windowsProtectionState windowsProtectionState 设备保护状态。 此属性是只读的。
users user 集合 与托管设备关联的主用户。
logCollectionRequests deviceLogCollectionResponse 集合 日志收集请求列表

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.managedDevice",
  "id": "String (identifier)",
  "userId": "String",
  "deviceName": "String",
  "managedDeviceOwnerType": "String",
  "deviceActionResults": [
    {
      "@odata.type": "microsoft.graph.deviceActionResult",
      "actionName": "String",
      "actionState": "String",
      "startDateTime": "String (timestamp)",
      "lastUpdatedDateTime": "String (timestamp)"
    }
  ],
  "enrolledDateTime": "String (timestamp)",
  "lastSyncDateTime": "String (timestamp)",
  "operatingSystem": "String",
  "complianceState": "String",
  "jailBroken": "String",
  "managementAgent": "String",
  "osVersion": "String",
  "easActivated": true,
  "easDeviceId": "String",
  "easActivationDateTime": "String (timestamp)",
  "azureADRegistered": true,
  "deviceEnrollmentType": "String",
  "activationLockBypassCode": "String",
  "emailAddress": "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
  },
  "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"
  },
  "subscriberCarrier": "String",
  "meid": "String",
  "totalStorageSpaceInBytes": 1024,
  "freeStorageSpaceInBytes": 1024,
  "managedDeviceName": "String",
  "partnerReportedThreatState": "String",
  "requireUserEnrollmentApproval": true,
  "managementCertificateExpirationDate": "String (timestamp)",
  "iccid": "String",
  "udid": "String",
  "notes": "String",
  "ethernetMacAddress": "String",
  "physicalMemoryInBytes": 1024,
  "enrollmentProfileName": "String"
}