更新 windowsManagedDevice

命名空间:microsoft.graph

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

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

更新 windowsManagedDevice 对象的 属性。

先决条件

要调用此 API,需要以下权限之一。要了解详细信息,包括如何选择权限的信息,请参阅权限

权限类型 权限(从最低特权到最高特权)
委派(工作或学校帐户) DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All
委派(个人 Microsoft 帐户) 不支持。
Application DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All

HTTP 请求

PATCH /deviceManagement/managedDevices/{managedDeviceId}
PATCH /deviceManagement/comanagedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceHealthScripts/{deviceHealthScriptId}/deviceRunStates/{deviceHealthScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/deviceRunStates/{deviceComplianceScriptDeviceStateId}/managedDevice
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices/{managedDeviceId}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}

请求标头

标头
Authorization Bearer <token>。必需。
接受 application/json

请求正文

在请求正文中,为 windowsManagedDevice 对象提供 JSON 表示形式。

下表显示了创建 windowsManagedDevice 时所需的属性。

属性 类型 说明
id 字符串 设备的唯一标识符。 此属性是只读的。 继承自 managedDevice
userId 字符串 与设备关联的用户的唯一标识符。 此属性是只读的。 继承自 managedDevice
deviceName String 设备的名称。 此属性是只读的。 继承自 managedDevice
hardwareInformation hardwareInformation 设备的硬性详细信息。 包括存储空间、制造商、序列号等信息。此属性是只读的。 继承自 managedDevice
ownerType ownerType 设备的所有权。 可以是从 managedDevice 继承的“公司”或“个人”。 可取值为:unknowncompanypersonal
managedDeviceOwnerType managedDeviceOwnerType 设备的所有权。 可以是从 managedDevice 继承的“公司”或“个人”。 可取值为:unknowncompanypersonal
deviceActionResults deviceActionResult 集合 ComplexType deviceActionResult 对象的列表。 此属性是只读的。 继承自 managedDevice
managementState managementState 设备的管理状态。 此属性是只读的。 继承自 managedDevice。 可取值为:managedretirePendingretireFailedwipePendingwipeFailedunhealthydeletePendingretireIssuedwipeIssuedwipeCanceledretireCanceleddiscovered
enrolledDateTime DateTimeOffset 设备的注册时间。 此属性是只读的。 继承自 managedDevice
lastSyncDateTime DateTimeOffset 设备上次成功完成与 Intune 同步的日期和时间。 此属性是只读的。 继承自 managedDevice
chassisType chassisType 设备的底盘类型。 此属性是只读的。 继承自 managedDevice。 可取值为:unknowndesktoplaptopworksWorkstationenterpriseServerphonetabletmobileOthermobileUnknown
operatingSystem String 设备的操作系统。 Windows、iOS 等。此属性是只读的。 继承自 managedDevice
deviceType deviceType 设备的平台。 此属性是只读的。 继承自 managedDevice。 可能的值为:desktopwindowsRTwinMO6nokiawindowsPhonemacwinEmbedded``winCE、、iPhoneiPadiPodiSocConsumer``androidunixmacMDM``holoLenssurfaceHub、、androidForWorkunknown``cloudPC``palm``androidEnterprise``windows10x``androidnGMS``chromeOS``linux``blackberry
complianceState complianceState 设备的符合性状态。 此属性是只读的。 继承自 managedDevice。 可取值为:unknowncompliantnoncompliantconflicterrorinGracePeriodconfigManager
jailBroken String 设备是否已越狱或取得 root 权限。 此属性是只读的。 继承自 managedDevice
managementAgent managementAgentType 设备的管理通道。 Intune、EAS 等。此属性是只读的。 继承自 managedDevice。 可能的值为:eas、、mdmeasMdm``intuneClienteasIntuneClientconfigurationManagerClientconfigurationManagerClientMdmunknown``configurationManagerClientMdmEasjamfgoogleCloudDevicePolicyController``microsoft365ManagedMdm、、msSenseintuneAosp
osVersion String 设备的操作系统版本。 此属性是只读的。 继承自 managedDevice
easActivated Boolean 设备是否已激活 Exchange ActiveSync。 此属性是只读的。 继承自 managedDevice
easDeviceId String 设备的 Exchange ActiveSync ID。 此属性是只读的。 继承自 managedDevice
easActivationDateTime DateTimeOffset 设备的 Exchange ActivationSync 激活时间。 此属性是只读的。 继承自 managedDevice
aadRegistered Boolean 设备是否已注册 Azure Active Directory。 此属性是只读的。 继承自 managedDevice
azureADRegistered Boolean 设备是否已注册 Azure Active Directory。 此属性是只读的。 继承自 managedDevice
deviceEnrollmentType deviceEnrollmentType 设备的注册类型。 此属性是只读的。 继承自 managedDevice。 可能的值为:、、、appleBulkWithUser``deviceEnrollmentManagerappleBulkWithoutUserwindowsAzureADJoinwindowsBulkUserlesswindowsAutoEnrollmentwindowsBulkAzureDomainJoinwindowsAzureADJoinUsingDeviceAuth``windowsCoManagementappleUserEnrollmentappleUserEnrollmentWithServiceAccountazureAdJoinUsingAzureVmExtensionandroidEnterpriseDedicatedDeviceandroidEnterpriseFullyManagedandroidEnterpriseCorporateWorkProfile``userEnrollment``unknown
lostModeState lostModeState 指示是否启用或禁用了“丢失”模式。 此属性是只读的。 继承自 managedDevice。 可取值为:disabledenabled
activationLockBypassCode String 允许绕过设备上的激活锁的代码。 此属性是只读的。 继承自 managedDevice
emailAddress String 与设备关联的用户的电子邮件 () 。 此属性是只读的。 继承自 managedDevice
azureActiveDirectoryDeviceId String Azure Active Directory 设备的唯一标识符。 只读。 此属性是只读的。 继承自 managedDevice
azureADDeviceId String Azure Active Directory 设备的唯一标识符。 只读。 此属性是只读的。 继承自 managedDevice
deviceRegistrationState deviceRegistrationState 设备注册状态。 此属性是只读的。 继承自 managedDevice。 可取值为:notRegisteredregisteredrevokedkeyConflictapprovalPendingcertificateResetnotRegisteredPendingEnrollmentunknown
deviceCategoryDisplayName String 设备类别显示名称。 此属性是只读的。 继承自 managedDevice
isSupervised Boolean 设备监督状态。 此属性是只读的。 继承自 managedDevice
exchangeLastSuccessfulSyncDateTime DateTimeOffset 设备上次与 Exchange 联系的时间。 此属性是只读的。 继承自 managedDevice
exchangeAccessState deviceManagementExchangeAccessState Exchange 中设备的访问状态。 此属性是只读的。 继承自 managedDevice。 可取值为:noneunknownallowedblockedquarantined
exchangeAccessStateReason deviceManagementExchangeAccessStateReason Exchange 中设备访问状态的出现原因。 此属性是只读的。 继承自 managedDevice。 可取值为:noneunknownexchangeGlobalRuleexchangeIndividualRuleexchangeDeviceRuleexchangeUpgradeexchangeMailboxPolicyothercompliantnotCompliantnotEnrolledunknownLocationmfaRequiredazureADBlockDueToAccessPolicycompromisedPassworddeviceNotKnownWithManagedApp
remoteAssistanceSessionUrl String 允许与设备建立远程协助会话的 URL。 此属性是只读的。 继承自 managedDevice
remoteAssistanceSessionErrorDetails String 用于在创建远程协助会话对象时识别问题的错误字符串。 此属性是只读的。 继承自 managedDevice
isEncrypted Boolean 设备加密状态。 此属性是只读的。 继承自 managedDevice
userPrincipalName String 设备用户主体名称。 此属性是只读的。 继承自 managedDevice
model String 设备的模型。 此属性是只读的。 继承自 managedDevice
manufacturer String 设备制造商。 此属性是只读的。 继承自 managedDevice
imei String IMEI。 此属性是只读的。 继承自 managedDevice
complianceGracePeriodExpirationDateTime DateTimeOffset 设备符合性宽限期到期时的 DateTime。 此属性是只读的。 继承自 managedDevice
serialNumber String SerialNumber。 此属性是只读的。 继承自 managedDevice
phoneNumber String 设备的电话号码。 此属性是只读的。 继承自 managedDevice
androidSecurityPatchLevel String Android 安全修补程序级别。 此属性是只读的。 继承自 managedDevice
userDisplayName String 用户显示名称。 此属性是只读的。 继承自 managedDevice
configurationManagerClientEnabledFeatures configurationManagerClientEnabledFeatures 启用了 ConfigrMgr 客户端的功能。 此属性是只读的。 继承自 managedDevice
wiFiMacAddress String Wi-Fi MAC。 此属性是只读的。 继承自 managedDevice
deviceHealthAttestationState deviceHealthAttestationState 设备运行状况证明状态。 此属性是只读的。 继承自 managedDevice
subscriberCarrier String 订阅服务器运营商。 此属性是只读的。 继承自 managedDevice
meid String 梅德 此属性是只读的。 继承自 managedDevice
totalStorageSpaceInBytes Int64 总存储量(以字节为单位)。 此属性是只读的。 继承自 managedDevice
freeStorageSpaceInBytes Int64 以字节为单位的免费存储。 此属性是只读的。 继承自 managedDevice
managedDeviceName String 用于识别设备的自动生成的名称。 可以覆盖为用户友好名称。 继承自 managedDevice
partnerReportedThreatState managedDevicePartnerReportedHealthState 指示帐户和设备正在使用移动威胁防护合作伙伴时设备的威胁状态。 只读。 此属性是只读的。 继承自 managedDevice。 可取值为:unknownactivateddeactivatedsecuredlowSeveritymediumSeverityhighSeverityunresponsivecompromisedmisconfigured
retireAfterDateTime DateTimeOffset 指示设备因计划操作而自动停用的时间。 此属性是只读的。 继承自 managedDevice
usersLoggedOn loggedOnUser 集合 指示设备用户上一次登录。 此属性是只读的。 继承自 managedDevice
preferMdmOverGroupPolicyAppliedDateTime DateTimeOffset 报告已设置 preferMdmOverGroupPolicy 设置的 DateTime。 设置时,如果存在冲突,Intune MDM 设置将替代组策略设置。 只读。 此属性是只读的。 继承自 managedDevice
autopilotEnrolled Boolean 报告是否通过自动试点注册托管设备。 此属性是只读的。 继承自 managedDevice
requireUserEnrollmentApproval Boolean 报告托管 iOS 设备是否为用户批准注册。 此属性是只读的。 继承自 managedDevice
managementCertificateExpirationDate DateTimeOffset 报告设备管理证书过期日期。 此属性是只读的。 继承自 managedDevice
iccid 字符串 集成电路卡标识符,它是 SIM 卡的唯一标识号。 此属性是只读的。 继承自 managedDevice
udid 字符串 iOS 和 macOS 设备的唯一设备标识符。 此属性是只读的。 继承自 managedDevice
roleScopeTagIds String collection 此设备实例的范围标记 ID 列表。 继承自 managedDevice
windowsActiveMalwareCount Int32 此 Windows 设备的活动恶意软件计数。 此属性是只读的。 继承自 managedDevice
windowsRemediatedMalwareCount Int32 此 Windows 设备的修正恶意软件计数。 此属性是只读的。 继承自 managedDevice
notes String IT 管理员从 managedDevice 继承的设备上的说明
configurationManagerClientHealthState configurationManagerClientHealthState Configuration Manager 客户端运行状况状态,仅对从 managedDevice 继承的 MDM/ConfigMgr 代理管理的设备有效
configurationManagerClientInformation configurationManagerClientInformation Configuration Manager 客户端信息,仅适用于由从 managedDevice 继承的 ConfigMgr 代理托管、决斗托管或三管理的设备
ethernetMacAddress String 以太网 MAC。 此属性是只读的。 继承自 managedDevice
physicalMemoryInBytes Int64 总内存(以字节为单位)。 此属性是只读的。 继承自 managedDevice
processorArchitecture managedDeviceArchitecture 处理器体系结构。 此属性是只读的。 继承自 managedDevice。 可取值为:unknownx86x64armarM64
specificationVersion String 规范版本。 此属性是只读的。 继承自 managedDevice
joinType joinType managedDevice 继承的设备联接类型。 可能的值是:unknownazureADJoinedazureADRegisteredhybridAzureADJoined
skuFamily String managedDevice 继承的设备 sku 系列
skuNumber Int32 设备 sku 编号,另请参阅: https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo。 要2147483647的有效值 0。 此属性是只读的。 继承自 managedDevice
managementFeatures managedDeviceManagementFeatures managedDevice 继承的设备管理功能。 可取值为:nonemicrosoftManagedDesktop
chromeOSDeviceInfo chromeOSDeviceProperty 集合 ChromeOS 设备的属性列表。 继承自 managedDevice
enrollmentProfileName String 分配给设备的注册配置文件的名称。 默认值为空字符串,指示未进行过注册配置文件。 此属性是只读的。 继承自 managedDevice
bootstrapTokenEscrowed Boolean 报告托管设备是否具有托管的 Bootstrap 令牌。 这仅适用于 macOS 设备。 如果为 FALSE,则不托管任何启动令牌。 如果为 TRUE,则设备已使用Intune托管启动令牌。 此属性是只读的。 继承自 managedDevice
deviceFirmwareConfigurationInterfaceManaged 布尔 指示设备是否托管 DFCI。 如果为 TRUE,则由 DFCI 管理设备。 如果为 FALSE,则设备不受 DFCI 管理。 默认值为 FALSE。 继承自 managedDevice

响应

如果成功,此方法在响应正文中返回 200 OK 响应代码和更新 的 windowsManagedDevice 对象。

示例

请求

下面是一个请求示例。

PATCH https://graph.microsoft.com/beta/deviceManagement/managedDevices/{managedDeviceId}
Content-type: application/json
Content-length: 9099

{
  "@odata.type": "#microsoft.graph.windowsManagedDevice",
  "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"
  },
  "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
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family 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
}

响应

下面是一个响应示例。注意:为了简单起见,可能会将此处所示的响应对象截断。将从实际调用中返回所有属性。

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 9148

{
  "@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"
  },
  "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
  },
  "ethernetMacAddress": "Ethernet Mac Address value",
  "physicalMemoryInBytes": 5,
  "processorArchitecture": "x86",
  "specificationVersion": "Specification Version value",
  "joinType": "azureADJoined",
  "skuFamily": "Sku Family 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
}