windowsManagedDevice 资源类型

项目
07/07/2022

命名空间：microsoft.graph

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

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

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

方法

方法	返回类型	说明
列出 windowsManagedDevices	windowsManagedDevice 集合	列出 windowsManagedDevice 对象的属性和关系。
获取 windowsManagedDevice	windowsManagedDevice	读取 windowsManagedDevice 对象的属性和关系。
创建 windowsManagedDevice	windowsManagedDevice	创建新的 windowsManagedDevice 对象。
删除 windowsManagedDevice	None	删除 windowsManagedDevice。
更新 windowsManagedDevice	windowsManagedDevice	更新 windowsManagedDevice 对象的属性。

属性

属性	类型	说明
id	String	设备的唯一标识符。此属性是只读的。继承自 managedDevice
userId	String	与设备关联的用户的唯一标识符。此属性是只读的。继承自 managedDevice
deviceName	String	设备的名称。此属性是只读的。继承自 managedDevice
hardwareInformation	hardwareInformation	设备的硬性详细信息。包括存储空间、制造商、序列号等信息。此属性是只读的。继承自 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`、`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	设备的符合性状态。此属性是只读的。继承自 managedDevice。可取值为：`unknown`、`compliant`、`noncompliant`、`conflict`、`error`、`inGracePeriod`、`configManager`。
jailBroken	String	设备是否已越狱或取得 root 权限。此属性是只读的。继承自 managedDevice
managementAgent	managementAgentType	设备的管理通道。 Intune、EAS 等。此属性是只读的。继承自 managedDevice。可能的值为：`eas`、、`mdm`、easMdm``intuneClient、`easIntuneClient`、`configurationManagerClient`、`configurationManagerClientMdm`、unknown``configurationManagerClientMdmEas、`jamf`、googleCloudDevicePolicyController``microsoft365ManagedMdm、、`msSense`。 `intuneAosp`
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``deviceEnrollmentManager、`appleBulkWithoutUser`、`windowsAzureADJoin`、`windowsBulkUserless`、`windowsAutoEnrollment`、`windowsBulkAzureDomainJoin`、windowsAzureADJoinUsingDeviceAuth``windowsCoManagement、`appleUserEnrollment`、`appleUserEnrollmentWithServiceAccount`、`azureAdJoinUsingAzureVmExtension`、`androidEnterpriseDedicatedDevice`、`androidEnterpriseFullyManaged`、 androidEnterpriseCorporateWorkProfile``userEnrollment``unknown
lostModeState	lostModeState	指示是否启用或禁用了“丢失”模式。此属性是只读的。继承自 managedDevice。可取值为：`disabled`、`enabled`。
activationLockBypassCode	String	允许绕过设备上的激活锁的代码。此属性是只读的。继承自 managedDevice
emailAddress	String	与设备关联的用户的电子邮件 () 。此属性是只读的。继承自 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	梅德此属性是只读的。继承自 managedDevice
totalStorageSpaceInBytes	Int64	总存储量（以字节为单位）。此属性是只读的。继承自 managedDevice
freeStorageSpaceInBytes	Int64	以字节为单位的免费存储。此属性是只读的。继承自 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	字符串	集成电路卡标识符，它是 SIM 卡的唯一标识号。此属性是只读的。继承自 managedDevice
udid	String	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。可取值为：`unknown`、`x86`、`x64`、`arm`、`arM64`。
specificationVersion	String	规范版本。此属性是只读的。继承自 managedDevice
joinType	joinType	从 managedDevice 继承的设备联接类型。可能的值是：`unknown`、`azureADJoined`、`azureADRegistered`、`hybridAzureADJoined`。
skuFamily	String	从 managedDevice 继承的设备 sku 系列
skuNumber	Int32	设备 sku 编号，另请参阅： https://docs.microsoft.com/windows/win32/api/sysinfoapi/nf-sysinfoapi-getproductinfo。要2147483647的有效值 0。此属性是只读的。继承自 managedDevice
managementFeatures	managedDeviceManagementFeatures	从 managedDevice 继承的设备管理功能。可取值为：`none`、`microsoftManagedDesktop`。
chromeOSDeviceInfo	chromeOSDeviceProperty 集合	ChromeOS 设备的属性列表。继承自 managedDevice
enrollmentProfileName	String	分配给设备的注册配置文件的名称。默认值为空字符串，指示未进行过注册配置文件。此属性是只读的。继承自 managedDevice
bootstrapTokenEscrowed	Boolean	报告托管设备是否具有托管的 Bootstrap 令牌。这仅适用于 macOS 设备。如果为 FALSE，则不托管任何启动令牌。如果为 TRUE，则设备已使用Intune托管启动令牌。此属性是只读的。继承自 managedDevice
deviceFirmwareConfigurationInterfaceManaged	布尔	指示设备是否托管 DFCI。如果为 TRUE，则由 DFCI 管理设备。如果为 FALSE，则设备不受 DFCI 管理。默认值为 FALSE。继承自 managedDevice

关系

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

JSON 表示形式

下面是资源的 JSON 表示形式。

{
  "@odata.type": "#microsoft.graph.windowsManagedDevice",
  "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
}

windowsManagedDevice 资源类型

方法

属性

关系

JSON 表示形式

反馈