创建 windowsManagedDevice
命名空间：microsoft.graph
重要： /beta 版本下的 Microsoft Graph API 可能会更改;不支持生产使用。
注意：适用于 Intune 的 Microsoft Graph API 需要适用于租户的活动 Intune 许可证。
创建新的 windowsManagedDevice 对象。
此 API 可用于以下国家级云部署。
| 全局服务 | 美国政府 L4 | 美国政府 L5 (DOD) | 由世纪互联运营的中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
权限
要调用此 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 | 持有者 {token}。 必填。 详细了解 身份验证和授权。 |
| 接受 | application/json |
请求正文
在请求正文中，提供 windowsManagedDevice 对象的 JSON 表示形式。
下表显示了创建 windowsManagedDevice 时所需的属性。
| 属性 | 类型 | 说明 |
|---|---|---|
| id | String | 设备的唯一标识符。 此属性是只读的。 继承自 managedDevice |
| userId | String | 与设备关联的用户的唯一标识符。 此属性是只读的。 继承自 managedDevice |
| deviceName | String | 设备的名称。 此属性是只读的。 继承自 managedDevice |
| hardwareInformation | hardwareInformation | 设备的硬性详细信息。 包括存储空间、制造商、序列号等信息。默认情况下，此类型的大多数属性都设置为 null/0/false，关联类型的枚举默认值。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 继承自 managedDevice |
| ownerType | ownerType | 设备的所有权。 可能的值为“company”或“personal”。 默认值为未知。 支持$filter运算符“eq”和“or”。 继承自 managedDevice。 可取值为：unknown、company、personal。 |
| managedDeviceOwnerType | managedDeviceOwnerType | 设备的所有权。 可以是“公司”或“个人”继承自 managedDevice。 可取值为：unknown、company、personal。 |
| deviceActionResults | deviceActionResult 集合 | ComplexType deviceActionResult 对象的列表。 此属性是只读的。 继承自 managedDevice |
| managementState | managementState | 设备的管理状态。 示例：Managed、RetirePending 等。默认为托管。 支持$filter运算符“eq”和“or”。 此属性是只读的。 继承自 managedDevice。 可取值为：managed、retirePending、retireFailed、wipePending、wipeFailed、unhealthy、deletePending、retireIssued、wipeIssued、wipeCanceled、retireCanceled、discovered。 |
| enrolledDateTime | DateTimeOffset | 设备的注册时间。 支持$filter运算符“lt”和“gt”。 此属性是只读的。 继承自 managedDevice |
| lastSyncDateTime | DateTimeOffset | 设备上次成功完成与 Intune 同步的日期和时间。 支持$filter运算符“lt”和“gt”。 此属性是只读的。 继承自 managedDevice |
| chassisType | chassisType | 设备的机箱类型。 此属性是只读的。 继承自 managedDevice。 可取值为：unknown、desktop、laptop、worksWorkstation、enterpriseServer、phone、tablet、mobileOther、mobileUnknown。 |
| operatingSystem | String | 设备的操作系统。 Windows、iOS 等。此属性是只读的。 继承自 managedDevice |
| deviceType | deviceType | 设备的平台。 示例：桌面、WindowsRT 等。默认值为未知。 支持$filter运算符“eq”和“or”。 此属性是只读的。 继承自 managedDevice。 可能的值为：desktop、、windowsRT、holoLensmacwindowsPhonewinEmbeddediPhonewinCEiPadnokiaiPodandroidwinMO6macMDMiSocConsumerunixsurfaceHubandroidForWork、androidEnterprise、chromeOSandroidnGMSwindows10xblackberrypalmlinux、unknown、 。 cloudPC |
| complianceState | complianceState | 设备的符合性状态。 示例：符合性、冲突、错误等。默认值为未知。 支持$filter运算符“eq”和“or”。 此属性是只读的。 继承自 managedDevice。 可取值为：unknown、compliant、noncompliant、conflict、error、inGracePeriod、configManager。 |
| jailBroken | String | 设备是否越狱或已获取 root 权限。 默认值为空字符串。 支持$filter运算符“eq”和“or”。 此属性是只读的。 继承自 managedDevice |
| managementAgent | managementAgentType | 设备的管理通道。 示例：Intune、EAS 等。默认值未知。 支持$filter运算符“eq”和“or”。 此属性是只读的。 继承自 managedDevice。 可取值为：eas、mdm、easMdm、intuneClient、easIntuneClient、configurationManagerClient、configurationManagerClientMdm、configurationManagerClientMdmEas、unknown、jamf、googleCloudDevicePolicyController、microsoft365ManagedMdm、msSense、intuneAosp、google、unknownFutureValue。 |
| osVersion | String | 设备的操作系统版本。 此属性是只读的。 继承自 managedDevice |
| easActivated | Boolean | 设备是否已激活 Exchange ActiveSync。 此属性是只读的。 继承自 managedDevice |
| easDeviceId | String | 设备的 Exchange ActiveSync ID。 此属性是只读的。 继承自 managedDevice |
| easActivationDateTime | DateTimeOffset | 设备的 Exchange ActivationSync 激活时间。 此属性是只读的。 继承自 managedDevice |
| aadRegistered | 布尔值 | 设备是否已注册 Azure Active Directory。 此属性是只读的。 继承自 managedDevice |
| azureADRegistered | Boolean | 设备是否已注册 Azure Active Directory。 此属性是只读的。 继承自 managedDevice |
| deviceEnrollmentType | deviceEnrollmentType | 设备的注册类型。 此属性是只读的。 继承自 managedDevice。 可能的值为：、、、、deviceEnrollmentManagerwindowsAzureADJoinUsingDeviceAuthwindowsAutoEnrollmentappleBulkWithoutUserwindowsBulkUserlessappleBulkWithUserwindowsCoManagementwindowsBulkAzureDomainJoinwindowsAzureADJoin、appleUserEnrollmentandroidEnterpriseCorporateWorkProfileandroidEnterpriseDedicatedDeviceappleUserEnrollmentWithServiceAccountandroidEnterpriseFullyManagedazureAdJoinUsingAzureVmExtension、appleACMEBasicBYOD、、appleACMEDEPUserless、appleACMEDEPUDACompanyPortal、 。 appleACMEDEPUDAModernAuthappleACMEDEPUDASetupAsstLegacyuserEnrollmentunknown |
| lostModeState | lostModeState | 指示是启用或禁用丢失模式。 此属性是只读的。 继承自 managedDevice。 可取值为：disabled、enabled。 |
| activationLockBypassCode | String | 允许绕过托管设备上的激活锁的代码。 在 LIST 调用中作为 managedDevice 实体的一部分返回时，默认值为 Null (非默认属性) 。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 继承自 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 | 设备类别显示名称。 默认值为空字符串。 支持$filter运算符“eq”和“or”。 此属性是只读的。 继承自 managedDevice |
| isSupervised | 布尔值 | 设备受监督状态。 此属性是只读的。 继承自 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。 默认值为空字符串。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 此属性是只读的。 继承自 managedDevice |
| remoteAssistanceSessionErrorDetails | String | 用于在创建远程协助会话对象时识别问题的错误字符串。 此属性是只读的。 继承自 managedDevice |
| isEncrypted | 布尔值 | 设备加密状态。 此属性是只读的。 继承自 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 | 布尔值 | 报告托管设备是否通过自动试点注册。 此属性是只读的。 继承自 managedDevice |
| requireUserEnrollmentApproval | 布尔值 | 报告托管 iOS 设备是否为用户审批注册。 此属性是只读的。 继承自 managedDevice |
| managementCertificateExpirationDate | DateTimeOffset | 报告设备管理证书到期日期。 此属性是只读的。 继承自 managedDevice |
| iccid | String | 集成电路卡标识符，它是 SIM 卡的唯一标识号。 默认值为空字符串。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 继承自 managedDevice |
| udid | String | iOS 和 macOS 设备的唯一设备标识符。 默认值为空字符串。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 继承自 managedDevice |
| roleScopeTagIds | 字符串集合 | 此设备实例的范围标记 ID 列表。 继承自 managedDevice |
| windowsActiveMalwareCount | Int32 | 此 Windows 设备的活动恶意软件计数。 默认值为 0。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 此属性是只读的。 继承自 managedDevice |
| windowsRemediatedMalwareCount | Int32 | 此 Windows 设备的已修正恶意软件计数。 默认值为 0。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 此属性是只读的。 继承自 managedDevice |
| notes | String | IT 管理员创建的设备上的说明。默认值为 null。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 不支持 $搜索。 继承自 managedDevice |
| configurationManagerClientHealthState | configurationManagerClientHealthState | Configuration Manager 客户端运行状况状态，仅对 MDM/ConfigMgr 从 managedDevice 继承的代理管理的设备有效 |
| configurationManagerClientInformation | configurationManagerClientInformation | Configuration Manager 客户端信息，仅对从 managedDevice 继承ConfigMgr代理托管、duel-managed 或三管理的设备有效 |
| ethernetMacAddress | String | 指示设备的以太网 MAC 地址。 作为 managedDevice 实体的一部分返回时，默认值为 Null (非默认属性) 。 需要具有选择查询选项的单个 get 调用才能检索实际值。 示例：deviceManagement/managedDevices ({managedDeviceId}) ？$select=ethernetMacAddress 支持：$select。 不支持 $搜索。 此为只读属性。 此属性是只读的。 继承自 managedDevice |
| physicalMemoryInBytes | Int64 | 总内存（以字节为单位）。 默认值为 0。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 支持：$select。 此为只读属性。 此属性是只读的。 继承自 managedDevice |
| processorArchitecture | managedDeviceArchitecture | 处理器体系结构。 此属性是只读的。 继承自 managedDevice。 可取值为：unknown、x86、x64、arm、arM64。 |
| specificationVersion | String | 规范版本。 此属性是只读的。 继承自 managedDevice |
| joinType | joinType | 设备联接类型继承自 managedDevice。 可能的值是：unknown、azureADJoined、azureADRegistered、hybridAzureADJoined。 |
| skuFamily | String | 设备 SKU 系列继承自 managedDevice |
| securityPatchLevel | String | 这表示操作系统的安全修补程序级别。 这些特殊更新包含重要的安全修补程序。 对于 iOS/MacOS，它们采用 () 格式。 对于 android，其格式为 2017-08-07。 此属性是只读的。 继承自 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 设备的属性列表。 默认值为空列表。 若要检索实际值，需要使用设备 ID 进行 GET 调用，并将其包含在 select 参数中。 继承自 managedDevice |
| enrollmentProfileName | String | 分配给设备的注册配置文件的名称。 默认值为空字符串，指示未执行任何注册配置文件。 此属性是只读的。 继承自 managedDevice |
| bootstrapTokenEscrowed | 布尔值 | 报告托管设备是否具有托管的启动令牌。 这仅适用于 macOS 设备。 若要获取，请在 select 子句中包含 BootstrapTokenEscrowed，并使用设备 ID 进行查询。如果为 FALSE，则不会托管启动令牌。 如果为 TRUE，则设备已使用Intune托管启动令牌。 此属性是只读的。 继承自 managedDevice |
| deviceFirmwareConfigurationInterfaceManaged | 布尔值 | 指示设备是否受 DFCI 管理。 如果为 TRUE，则设备受 DFCI 管理。 如果为 FALSE，则设备不受 DFCI 管理。 默认值为 FALSE。 继承自 managedDevice |
| deviceIdentityAttestationDetail | deviceIdentityAttestationDetail | 指示托管设备的证明状态。 以哪种方式。 默认值：未知。 继承自 managedDevice |
响应
如果成功，此方法在 201 Created 响应正文中返回响应代码和 windowsManagedDevice 对象。
示例
请求
下面是一个请求示例。
POST https://graph.microsoft.com/beta/deviceManagement/managedDevices
Content-type: application/json
Content-length: 9627
{
"@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",
"memoryIntegrityProtection": "enabled",
"memoryAccessProtection": "enabled",
"virtualizationBasedSecurity": "enabled",
"firmwareProtection": "systemGuardSecureLaunch",
"systemManagementMode": "level1",
"securedCorePC": "enabled"
},
"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",
"securityPatchLevel": "Security Patch Level 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,
"deviceIdentityAttestationDetail": {
"@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
"deviceIdentityAttestationStatus": "trusted"
}
}
响应
下面是一个响应示例。 注意：为简洁起见，可能会截断此处显示的响应对象。 将从实际调用中返回所有属性。
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 9676
{
"@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",
"memoryIntegrityProtection": "enabled",
"memoryAccessProtection": "enabled",
"virtualizationBasedSecurity": "enabled",
"firmwareProtection": "systemGuardSecureLaunch",
"systemManagementMode": "level1",
"securedCorePC": "enabled"
},
"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",
"securityPatchLevel": "Security Patch Level 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,
"deviceIdentityAttestationDetail": {
"@odata.type": "microsoft.graph.deviceIdentityAttestationDetail",
"deviceIdentityAttestationStatus": "trusted"
}
}
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈