managedDevice 资源类型

项目
10/10/2024

命名空间：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 对象的属性。

| 停用操作 |无 |停用设备 | |擦除操作 |无 |擦除设备 | |resetPasscode 操作 |无 |重置密码 | |remoteLock 操作 |无 |远程锁定 | |requestRemoteAssistance 操作 |无 |请求远程协助 | |disableLostMode 操作 |无 |禁用丢失模式 | |locateDevice 操作 |无 |查找设备 | |bypassActivationLock 操作 |无 |绕过激活锁 | |rebootNow 操作 |无 |重新启动设备| |shutDown 操作 |无 |关闭设备| |recoverPasscode 操作 |无 |恢复密码 | |cleanWindowsDevice 操作 |无 |清理 Windows 设备 | |logoutSharedAppleDeviceActiveUser 操作 |无 |注销共享 Apple 设备活动用户 | |deleteUserFromSharedAppleDevice 操作 |无 |从共享的 Apple 设备中删除用户 | |syncDevice 操作 |无|||windowsDefenderScan 操作 |无|||windowsDefenderUpdateSignatures 操作 |无|||updateWindowsDeviceAccount 操作 |无||

属性

属性	类型	说明
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"
}

通过

managedDevice 资源类型

方法

属性

关系

JSON 表示形式

反馈

其他资源