managedDevice 资源类型

项目
07/07/2022

命名空间：microsoft.graph

重要： /beta 版本下的 Microsoft Graph API 可能会发生更改;不支持生产用途。

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

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

方法

方法	返回类型	说明
Get managedDevice	managedDevice	读取 managedDevice 对象的属性和关系。
Update managedDevice	managedDevice	更新 managedDevice 对象的属性。
executeAction 操作	bulkManagedDeviceActionResult	尚未记录
enableLostMode 操作	None	启用丢失模式
playLostModeSound 操作	None	播放丢失模式声音
setDeviceName 操作	None	设置设备的设备名称。
activateDeviceEsim 操作	None	在设备上激活 eSIM。
rotateFileVaultKey 操作	无	尚未记录
getFileVaultKey 函数	String	尚未记录
createDeviceLogCollectionRequest 操作	deviceLogCollectionResponse	尚未记录
retire 操作	无	停用设备
wipe 操作	无	擦除设备
resetPasscode 操作	无	重置密码
remoteLock 操作	无	远程锁定
requestRemoteAssistance 操作	无	请求远程协助
disableLostMode 操作	无	禁用丢失模式
locateDevice 操作	无	查找设备
bypassActivationLock 操作	无	跳过激活锁
rebootNow 操作	无	重新启动设备
shutDown 操作	无	关闭设备
recoverPasscode 操作	无	恢复密码
cleanWindowsDevice 操作	无	干净的 Windows 设备
logoutSharedAppleDeviceActiveUser 操作	无	注销共享 Apple 设备活动用户
deleteUserFromSharedAppleDevice 操作	无	从共享 Apple 设备中删除用户
syncDevice 操作	无	尚未记录
windowsDefenderScan 操作	无	尚未记录
windowsDefenderUpdateSignatures 操作	无	尚未记录
updateWindowsDeviceAccount 操作	无	尚未记录
revokeAppleVppLicenses 操作	None	吊销设备的所有 Apple Vpp 许可证
rotateBitLockerKeys 操作	无	旋转 BitLockerKeys
sendCustomNotificationToCompanyPortal 操作	无	尚未记录
triggerConfigurationManagerAction 操作	None	ConfigurationManager 客户端上的触发器操作
取消预配操作	无	尚未记录
禁用操作	无	尚未记录
可重置操作	无	尚未记录
moveDevicesToOU 操作	无	尚未记录
removeDeviceFirmwareConfigurationInterfaceManagement 操作	None	从设备固件配置接口管理中删除设备
getOemWarranty 函数	oemWarranty	尚未记录

属性

属性	类型	说明
id	字符串	设备的唯一标识符。此属性是只读的。
userId	String	与设备关联的用户的唯一标识符。此属性是只读的。
deviceName	String	设备的名称。此属性是只读的。
hardwareInformation	hardwareInformation	设备的硬性详细信息。包括存储空间、制造商、序列号等信息。此属性是只读的。
ownerType	ownerType	设备的所有权。可以是“公司”或“个人”。可取值为：`unknown`、`company`、`personal`。
managedDeviceOwnerType	managedDeviceOwnerType	设备的所有权。可以是“公司”或“个人”。可取值为：`unknown`、`company`、`personal`。
deviceActionResults	deviceActionResult 集合	ComplexType deviceActionResult 对象的列表。此属性是只读的。
managementState	managementState	设备的管理状态。此属性是只读的。可取值为：`managed`、`retirePending`、`retireFailed`、`wipePending`、`wipeFailed`、`unhealthy`、`deletePending`、`retireIssued`、`wipeIssued`、`wipeCanceled`、`retireCanceled`、`discovered`。
enrolledDateTime	DateTimeOffset	设备的注册时间。此属性是只读的。
lastSyncDateTime	DateTimeOffset	设备上次成功完成与 Intune 同步的日期和时间。此属性是只读的。
chassisType	chassisType	设备的底盘类型。此属性是只读的。可取值为：`unknown`、`desktop`、`laptop`、`worksWorkstation`、`enterpriseServer`、`phone`、`tablet`、`mobileOther`、`mobileUnknown`。
operatingSystem	String	设备的操作系统。 Windows、iOS 等。此属性是只读的。
deviceType	deviceType	设备的平台。此属性是只读的。可能的值为：`desktop`、`windowsRT`、`winMO6`、`nokia`、`windowsPhone`、`mac`、winEmbedded``winCE、、`iPhone`、`iPad`、`iPod`、iSocConsumer``android、`unix`、macMDM``holoLens、`surfaceHub`、、`androidForWork`、 unknown``cloudPC``palm``androidEnterprise``windows10x``androidnGMS``chromeOS``linux``blackberry
complianceState	complianceState	设备的符合性状态。此属性是只读的。可取值为：`unknown`、`compliant`、`noncompliant`、`conflict`、`error`、`inGracePeriod`、`configManager`。
jailBroken	String	设备是否已越狱或取得 root 权限。此属性是只读的。
managementAgent	managementAgentType	设备的管理通道。 Intune、EAS 等。此属性是只读的。可能的值为：`eas`、、`mdm`、easMdm``intuneClient、`easIntuneClient`、`configurationManagerClient`、`configurationManagerClientMdm`、unknown``configurationManagerClientMdmEas、`jamf`、googleCloudDevicePolicyController``microsoft365ManagedMdm、、`msSense`。 `intuneAosp`
osVersion	String	设备的操作系统版本。此属性是只读的。
easActivated	Boolean	设备是否已激活 Exchange ActiveSync。此属性是只读的。
easDeviceId	String	设备的 Exchange ActiveSync ID。此属性是只读的。
easActivationDateTime	DateTimeOffset	设备的 Exchange ActivationSync 激活时间。此属性是只读的。
aadRegistered	Boolean	设备是否已注册 Azure Active Directory。此属性是只读的。
azureADRegistered	Boolean	设备是否已注册 Azure Active Directory。此属性是只读的。
deviceEnrollmentType	deviceEnrollmentType	设备的注册类型。此属性是只读的。可能的值为：、、、appleBulkWithUser``deviceEnrollmentManager、`appleBulkWithoutUser`、`windowsAzureADJoin`、`windowsBulkUserless`、`windowsAutoEnrollment`、`windowsBulkAzureDomainJoin`、windowsAzureADJoinUsingDeviceAuth``windowsCoManagement、`appleUserEnrollment`、`appleUserEnrollmentWithServiceAccount`、`azureAdJoinUsingAzureVmExtension`、`androidEnterpriseDedicatedDevice`、`androidEnterpriseFullyManaged`、 androidEnterpriseCorporateWorkProfile``userEnrollment``unknown
lostModeState	lostModeState	指示是否启用或禁用了“丢失”模式。此属性是只读的。可取值为：`disabled`、`enabled`。
activationLockBypassCode	String	允许绕过设备上的激活锁的代码。此属性是只读的。
emailAddress	String	与设备关联的用户的电子邮件 () 。此属性是只读的。
azureActiveDirectoryDeviceId	String	Azure Active Directory 设备的唯一标识符。只读。此属性是只读的。
azureADDeviceId	String	Azure Active Directory 设备的唯一标识符。只读。此属性是只读的。
deviceRegistrationState	deviceRegistrationState	设备注册状态。此属性是只读的。可取值为：`notRegistered`、`registered`、`revoked`、`keyConflict`、`approvalPending`、`certificateReset`、`notRegisteredPendingEnrollment`、`unknown`。
deviceCategoryDisplayName	String	设备类别显示名称。此属性是只读的。
isSupervised	Boolean	设备监督状态。此属性是只读的。
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。此属性是只读的。
remoteAssistanceSessionErrorDetails	String	用于在创建远程协助会话对象时识别问题的错误字符串。此属性是只读的。
isEncrypted	Boolean	设备加密状态。此属性是只读的。
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	梅德此属性是只读的。
totalStorageSpaceInBytes	Int64	总存储量（以字节为单位）。此属性是只读的。
freeStorageSpaceInBytes	Int64	以字节为单位的免费存储。此属性是只读的。
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	Boolean	报告是否通过自动试点注册托管设备。此属性是只读的。
requireUserEnrollmentApproval	布尔	报告托管 iOS 设备是否为用户批准注册。此属性是只读的。
managementCertificateExpirationDate	DateTimeOffset	报告设备管理证书过期日期。此属性是只读的。
iccid	String	集成电路卡标识符，它是 SIM 卡的唯一标识号。此属性是只读的。
udid	String	iOS 和 macOS 设备的唯一设备标识符。此属性是只读的。
roleScopeTagIds	String collection	此设备实例的范围标记 ID 列表。
windowsActiveMalwareCount	Int32	此 Windows 设备的活动恶意软件计数。此属性是只读的。
windowsRemediatedMalwareCount	Int32	此 Windows 设备的修正恶意软件计数。此属性是只读的。
notes	String	IT 管理员创建的设备上的说明
configurationManagerClientHealthState	configurationManagerClientHealthState	Configuration Manager 客户端运行状况状态，仅适用于由 MDM/ConfigMgr 代理管理的设备
configurationManagerClientInformation	configurationManagerClientInformation	Configuration Manager 客户端信息，仅适用于由 ConfigMgr 代理托管、决斗托管或三管理的设备
ethernetMacAddress	String	以太网 MAC。此属性是只读的。
physicalMemoryInBytes	Int64	总内存（以字节为单位）。此属性是只读的。
processorArchitecture	managedDeviceArchitecture	处理器体系结构。此属性是只读的。可取值为：`unknown`、`x86`、`x64`、`arm`、`arM64`。
specificationVersion	字符串	规范版本。此属性是只读的。
joinType	joinType	设备联接类型。可能的值是：`unknown`、`azureADJoined`、`azureADRegistered`、`hybridAzureADJoined`。
skuFamily	String	设备 sku 系列
skuNumber	Int32	设备 sku 编号，另请参阅： https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo。要2147483647的有效值 0。此属性是只读的。
managementFeatures	managedDeviceManagementFeatures	设备管理功能。可取值为：`none`、`microsoftManagedDesktop`。
chromeOSDeviceInfo	chromeOSDeviceProperty 集合	ChromeOS 设备的属性列表。
enrollmentProfileName	String	分配给设备的注册配置文件的名称。默认值为空字符串，指示未进行过注册配置文件。此属性是只读的。
bootstrapTokenEscrowed	Boolean	报告托管设备是否具有托管的 Bootstrap 令牌。这仅适用于 macOS 设备。如果为 FALSE，则不托管任何启动令牌。如果为 TRUE，则设备已使用Intune托管启动令牌。此属性是只读的。
deviceFirmwareConfigurationInterfaceManaged	布尔	指示设备是否托管 DFCI。如果为 TRUE，则由 DFCI 管理设备。如果为 FALSE，则设备不受 DFCI 管理。默认值为 FALSE。

关系

关系	类型	说明
detectedApps	detectedApp 集合	设备上当前安装的所有应用程序
deviceCategory	deviceCategory	设备类别
windowsProtectionState	windowsProtectionState	设备保护状态。此属性是只读的。
users	user 集合	与托管设备关联的主要用户。
logCollectionRequests	deviceLogCollectionResponse 集合	日志收集请求列表

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"
  },
  "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
  },
  "ethernetMacAddress": "String",
  "physicalMemoryInBytes": 1024,
  "processorArchitecture": "String",
  "specificationVersion": "String",
  "joinType": "String",
  "skuFamily": "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
}

managedDevice 资源类型

方法

属性

关系

JSON 表示形式

反馈