创建 windowsManagedDevice

项目
03/09/2023

命名空间：microsoft.graph

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

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

权限

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

权限类型	权限（从最低特权到最高特权）
委派（工作或学校帐户）	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All
委派（个人 Microsoft 帐户）	不支持。
应用程序	DeviceManagementConfiguration.ReadWrite.All、DeviceManagementManagedDevices.ReadWrite.All

HTTP 请求

POST /deviceManagement/managedDevices
POST /deviceManagement/comanagedDevices
POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/users/{userId}/managedDevices
POST /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/detectedApps/{detectedAppId}/managedDevices

请求标头

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

请求正文

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

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

属性	类型	说明
id	String	设备的唯一标识符。此属性是只读的。继承自 managedDevice
userId	String	与设备关联的用户的唯一标识符。此属性是只读的。继承自 managedDevice
deviceName	String	设备的名称。此属性是只读的。继承自 managedDevice
hardwareInformation	hardwareInformation	设备的硬性详细信息。包括存储空间、制造商、序列号等信息。返回 LIST managedDevices 中的默认值。实际值仅在具有设备 ID 且包含在 select 参数中的单el 设备 GET 调用中返回。支持：$select。不支持$Search。只读。此属性是只读的。继承自 managedDevice
ownerType	ownerType	设备的所有权。可以是“公司”或“个人”继承自 managedDevice。可取值为：`unknown`、`company`、`personal`。
managedDeviceOwnerType	managedDeviceOwnerType	设备的所有权。可以是“公司”或“个人”继承自 managedDevice。可取值为：`unknown`、`company`、`personal`。
deviceActionResults	deviceActionResult 集合	ComplexType deviceActionResult 对象的列表。此属性是只读的。继承自 managedDevice
managementState	managementState	设备的管理状态。此属性是只读的。继承自 managedDevice。可取值为：`managed`、`retirePending`、`retireFailed`、`wipePending`、`wipeFailed`、`unhealthy`、`deletePending`、`retireIssued`、`wipeIssued`、`wipeCanceled`、`retireCanceled`、`discovered`。
enrolledDateTime	DateTimeOffset	设备的注册时间。此属性是只读的。继承自 managedDevice
lastSyncDateTime	DateTimeOffset	设备上次成功完成与 Intune 同步的日期和时间。此属性是只读的。继承自 managedDevice
chassisType	chassisType	设备的机箱类型。此属性是只读的。继承自 managedDevice。可取值为：`unknown`、`desktop`、`laptop`、`worksWorkstation`、`enterpriseServer`、`phone`、`tablet`、`mobileOther`、`mobileUnknown`。
operatingSystem	String	设备的操作系统。 Windows、iOS 等。此属性是只读的。继承自 managedDevice
deviceType	deviceType	设备的平台。此属性是只读的。继承自 managedDevice。可能的值为：`desktop`、、`windowsRT`、`holoLensmacwindowsPhonewinEmbeddediPhonewinCEiPadnokiaiPodandroidwinMO6macMDMiSocConsumerunixsurfaceHubandroidForWork`、`androidEnterprise`、`chromeOSandroidnGMSwindows10xblackberrypalmlinux`、`unknown`、。 `cloudPC`
complianceState	complianceState	设备的符合性状态。此属性是只读的。继承自 managedDevice。可取值为：`unknown`、`compliant`、`noncompliant`、`conflict`、`error`、`inGracePeriod`、`configManager`。
jailBroken	String	设备是否已越狱或取得 root 权限。此属性是只读的。继承自 managedDevice
managementAgent	managementAgentType	设备的管理通道。 Intune、EAS 等。此属性是只读的。继承自 managedDevice。可能的值为：、、、、`easMdmconfigurationManagerClientMdmeasIntuneClientjamfunknownconfigurationManagerClientMdmEasconfigurationManagerClientintuneClient`、`googleCloudDevicePolicyController`、`microsoft365ManagedMdm`、。 `intuneAospmsSensemdmeas`
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。可能的值为：、、、、`deviceEnrollmentManagerappleBulkWithUserwindowsCoManagementwindowsBulkUserlesswindowsAutoEnrollmentwindowsAzureADJoinappleBulkWithoutUserwindowsBulkAzureDomainJoin`、`windowsAzureADJoinUsingDeviceAuthappleUserEnrollment`、、`appleUserEnrollmentWithServiceAccount`、`androidEnterpriseDedicatedDeviceazureAdJoinUsingAzureVmExtension`、。 `androidEnterpriseCorporateWorkProfileandroidEnterpriseFullyManageduserEnrollmentunknown`
lostModeState	lostModeState	指示是启用或禁用丢失模式。此属性是只读的。继承自 managedDevice。可取值为：`disabled`、`enabled`。
activationLockBypassCode	String	允许绕过托管设备上的激活锁的代码。在 LIST 调用中作为 managedDevice 实体的一部分返回时，默认值为 Null (非默认属性) 。需要具有选择查询选项的单个 GET 调用才能检索实际值。支持：$select。不支持$Search。只读。此属性是只读的。继承自 managedDevice
emailAddress	String	Email (与设备关联的用户的) 。此属性是只读的。继承自 managedDevice
azureActiveDirectoryDeviceId	String	Azure Active Directory 设备的唯一标识符。只读。此属性是只读的。继承自 managedDevice
azureADDeviceId	String	Azure Active Directory 设备的唯一标识符。只读。此属性是只读的。继承自 managedDevice
deviceRegistrationState	deviceRegistrationState	设备注册状态。此属性是只读的。继承自 managedDevice。可取值为：`notRegistered`、`registered`、`revoked`、`keyConflict`、`approvalPending`、`certificateReset`、`notRegisteredPendingEnrollment`、`unknown`。
deviceCategoryDisplayName	String	设备类别显示名称。此属性是只读的。继承自 managedDevice
isSupervised	Boolean	设备受监督状态。此属性是只读的。继承自 managedDevice
exchangeLastSuccessfulSyncDateTime	DateTimeOffset	设备上次与 Exchange 联系的时间。此属性是只读的。继承自 managedDevice
exchangeAccessState	deviceManagementExchangeAccessState	Exchange 中设备的访问状态。此属性是只读的。继承自 managedDevice。可取值为：`none`、`unknown`、`allowed`、`blocked`、`quarantined`。
exchangeAccessStateReason	deviceManagementExchangeAccessStateReason	Exchange 中设备访问状态的出现原因。此属性是只读的。继承自 managedDevice。可取值为：`none`、`unknown`、`exchangeGlobalRule`、`exchangeIndividualRule`、`exchangeDeviceRule`、`exchangeUpgrade`、`exchangeMailboxPolicy`、`other`、`compliant`、`notCompliant`、`notEnrolled`、`unknownLocation`、`mfaRequired`、`azureADBlockDueToAccessPolicy`、`compromisedPassword`、`deviceNotKnownWithManagedApp`。
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	MEID。此属性是只读的。继承自 managedDevice
totalStorageSpaceInBytes	Int64	总存储（以字节为单位）。此属性是只读的。继承自 managedDevice
freeStorageSpaceInBytes	Int64	可用存储（以字节为单位）。默认值为 0 。只读。此属性是只读的。继承自 managedDevice
managedDeviceName	String	用于识别设备的自动生成的名称。可以覆盖为用户友好名称。继承自 managedDevice
partnerReportedThreatState	managedDevicePartnerReportedHealthState	指示帐户和设备正在使用移动威胁防护合作伙伴时设备的威胁状态。只读。此属性是只读的。继承自 managedDevice。可取值为：`unknown`、`activated`、`deactivated`、`secured`、`lowSeverity`、`mediumSeverity`、`highSeverity`、`unresponsive`、`compromised`、`misconfigured`。
retireAfterDateTime	DateTimeOffset	指示设备因计划操作而自动停用的时间。此属性是只读的。继承自 managedDevice
usersLoggedOn	loggedOnUser 集合	指示设备的最后一个登录用户。此属性是只读的。继承自 managedDevice
preferMdmOverGroupPolicyAppliedDateTime	DateTimeOffset	报告设置了 preferMdmOverGroupPolicy 设置的 DateTime。设置后，如果发生冲突，Intune MDM 设置将替代组策略设置。只读。此属性是只读的。继承自 managedDevice
autopilotEnrolled	Boolean	报告托管设备是否通过自动试点注册。此属性是只读的。继承自 managedDevice
requireUserEnrollmentApproval	Boolean	报告托管 iOS 设备是否为用户审批注册。此属性是只读的。继承自 managedDevice
managementCertificateExpirationDate	DateTimeOffset	报告设备管理证书到期日期。此属性是只读的。继承自 managedDevice
iccid	String	集成电路卡标识符，它是 SIM 卡的唯一标识号。在 LIST managedDevices 中返回默认值 null。实际值仅在具有设备 ID 且包含在 select 参数中的单el 设备 GET 调用中返回。支持：$select。不支持$Search。只读。此属性是只读的。继承自 managedDevice
udid	String	iOS 和 macOS 设备的唯一设备标识符。在 LIST managedDevices 中返回默认值 null。实际值仅在具有设备 ID 且包含在 select 参数中的单el 设备 GET 调用中返回。支持：$select。不支持$Search。只读。此属性是只读的。继承自 managedDevice
roleScopeTagIds	字符串集合	此设备实例的范围标记 ID 列表。继承自 managedDevice
windowsActiveMalwareCount	Int32	此 Windows 设备的活动恶意软件计数。此属性是只读的。继承自 managedDevice
windowsRemediatedMalwareCount	Int32	此 Windows 设备的已修正恶意软件计数。此属性是只读的。继承自 managedDevice
notes	String	IT 管理员创建的设备上的说明。在 LIST managedDevices 中返回默认值 null。实际值仅在具有设备 ID 且包含在 select 参数中的单el 设备 GET 调用中返回。支持：$select。不支持$Search。继承自 managedDevice
configurationManagerClientHealthState	configurationManagerClientHealthState	Configuration Manager 客户端运行状况状态，仅对从 managedDevice 继承的 MDM/ConfigMgr 代理管理的设备有效
configurationManagerClientInformation	configurationManagerClientInformation	Configuration Manager 客户端信息，仅对从 managedDevice 继承的 ConfigMgr 代理托管、duel-managed 或三管理的设备有效
ethernetMacAddress	String	指示设备的以太网 MAC 地址。作为 managedDevice 实体的一部分返回时，默认值为 Null (非默认属性) 。需要具有选择查询选项的单个 get 调用才能检索实际值。示例：deviceManagement/managedDevices ({managedDeviceId}) ？$select=ethernetMacAddress 支持：$select。不支持$Search。只读。此属性是只读的。继承自 managedDevice
physicalMemoryInBytes	Int64	总内存（以字节为单位）。在 LIST managedDevices 中返回默认值 0。实际值仅在具有设备 ID 且包含在 select 参数中的单el 设备 GET 调用中返回。支持：$select。默认值为 0 。只读。此属性是只读的。继承自 managedDevice
processorArchitecture	managedDeviceArchitecture	处理器体系结构。此属性是只读的。继承自 managedDevice。可取值为：`unknown`、`x86`、`x64`、`arm`、`arM64`。
specificationVersion	String	规范版本。此属性是只读的。继承自 managedDevice
joinType	joinType	设备联接类型继承自 managedDevice。可能的值是：`unknown`、`azureADJoined`、`azureADRegistered`、`hybridAzureADJoined`。
skuFamily	String	设备 SKU 系列继承自 managedDevice
skuNumber	Int32	设备 SKU 编号，另请参阅： https://learn.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo。有效值 0 到 2147483647。此属性是只读的。继承自 managedDevice
managementFeatures	managedDeviceManagementFeatures	设备管理功能继承自 managedDevice。可取值为：`none`、`microsoftManagedDesktop`。
chromeOSDeviceInfo	chromeOSDeviceProperty 集合	ChromeOS 设备的属性列表。继承自 managedDevice
enrollmentProfileName	String	分配给设备的注册配置文件的名称。默认值为空字符串，指示未执行任何注册配置文件。此属性是只读的。继承自 managedDevice
bootstrapTokenEscrowed	Boolean	报告托管设备是否具有托管的启动令牌。这仅适用于 macOS 设备。若要获取，请在 select 子句中包含 BootstrapTokenEscrowed，并使用设备 ID 进行查询。如果为 FALSE，则不会托管启动令牌。如果为 TRUE，则设备已使用Intune托管启动令牌。此属性是只读的。继承自 managedDevice
deviceFirmwareConfigurationInterfaceManaged	Boolean	指示设备是否受 DFCI 管理。如果为 TRUE，则设备受 DFCI 管理。如果为 FALSE，则设备不受 DFCI 管理。默认值为 FALSE。继承自 managedDevice

响应

如果成功，此方法在 201 Created 响应正文中返回响应代码和 windowsManagedDevice 对象。

示例

请求

下面是一个请求示例。

POST https://graph.microsoft.com/beta/deviceManagement/managedDevices
Content-type: application/json
Content-length: 9145

{
  "@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,
    "clientVersion": "Client Version value"
  },
  "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 201 Created
Content-Type: application/json
Content-Length: 9194

{
  "@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,
    "clientVersion": "Client Version value"
  },
  "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
}

创建 windowsManagedDevice

权限

HTTP 请求

请求标头

请求正文

响应

示例

请求

响应

其他资源

其他资源