通过

hardwareInformation 资源类型

命名空间：microsoft.graph

重要：Microsoft支持Intune /beta API，但它们会受到更频繁的更改。 Microsoft建议尽可能使用版本 v1.0。 使用版本选择器检查 API 在 v1.0 版中的可用性。

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

给定设备的硬件信息。

属性

属性 类型 说明
serialNumber String 序号。
totalStorageSpace Int64 设备的总存储空间。
freeStorageSpace Int64 设备的可用存储空间。
imei String IMEI
meid String MEID
manufacturer String 设备的制造商
model String 设备的型号
phoneNumber String 设备的电话号码
subscriberCarrier String 设备的订阅者运营商
cellularTechnology String 设备的手机网络技术
wifiMac String 设备的 WiFi MAC 地址
operatingSystemLanguage String 设备的作系统语言
isSupervised 布尔值 设备的监督模式
isEncrypted 布尔值 设备的加密状态
batterySerialNumber String 设备当前电池的序列号
batteryHealthPercentage Int32 设备的当前电池运行状况百分比。 有效值为 0 至 100
batteryChargeCycles Int32 设备的当前电池经过的充电周期数。 有效值 0 到 2147483647
isSharedDevice 布尔值 共享 iPad
sharedDeviceCachedUsers sharedAppleDeviceUser 集合 共享 Apple 设备上的所有用户
tpmSpecificationVersion String 指定规范版本的字符串。
operatingSystemEdition String 指定 OS 版本的字符串。
deviceFullQualifiedDomainName String 返回设备 (的完全限定域名（如果有任何) ）。 如果设备未加入域，则返回空字符串。
deviceGuardVirtualizationBasedSecurityHardwareRequirementState deviceGuardVirtualizationBasedSecurityHardwareRequirementState 基于虚拟化的安全硬件要求状态。 可能的值包括 meetHardwareRequirements、secureBootRequired、dmaProtectionRequired、hyperVNotSupportedForGuestVM、hyperVNotAvailable。
deviceGuardVirtualizationBasedSecurityState deviceGuardVirtualizationBasedSecurityState 基于虚拟化的安全状态。 . 可取值包括：running、rebootRequired、require64BitArchitecture、notLicensed、notConfigured、doesNotMeetHardwareRequirements、other。
deviceGuardLocalSystemAuthorityCredentialGuardState deviceGuardLocalSystemAuthorityCredentialGuardState 本地系统机构 (LSA) 凭据防护状态。 . 可能的值包括 running、rebootRequired、notLicensed、notConfigured、virtualizationBasedSecurityNotRunning。
osBuildNumber String Android 设备上的作系统内部版本号
operatingSystemProductType Int32 指定 Windows作系统 ProductType 的 Int。 更多详细信息，请参阅 https://go.microsoft.com/fwlink/?linkid=2126950。 有效值 0 到 2147483647
ipAddressV4 String IPAddressV4
subnetAddress String SubnetAddress
esimIdentifier String eSIM 标识符
systemManagementBIOSVersion String SMBIOS 报告的 BIOS 版本
tpmManufacturer String 唯一命名 TPM 制造商的标识信息
tpmVersion String 制造商指定的 TPM 版本
wiredIPv4Addresses 字符串集合 有线 IPv4 地址的列表。 更新频率 (从设备同步到云存储的属性值更改的最大延迟) 为每天。 请注意，目前仅在 Windows 上运行的设备上支持此属性。
batteryLevelPercentage 双精度 电池电量（介于 0.0 和 100 之间），如果无法确定电池电量，则为 null。 此属性的更新频率是每次签到。 请注意，此属性目前仅在运行 iOS 5.0 及更高版本的设备上受支持，并且仅在获得设备信息访问权限时才可用。 有效值为 0 至 100
residentUsersCount Int32 如果无法确定此属性的值，则此设备上的当前用户数或默认 (null) 。 此属性的更新频率是每次签到。 请注意，目前仅在运行 iOS 13.4 及更高版本的设备上支持此属性，并且仅在获得设备信息访问权限时才可用。 有效值 0 到 2147483647
productName String 产品名称，例如 iPad8、12 等。此属性的更新频率为每周。 请注意，此属性目前仅在 iOS/MacOS 设备上受支持，并且仅在获取设备信息访问权限时才可用。
deviceLicensingStatus deviceLicensingStatus 基于设备的订阅许可状态。 此属性的更新频率为每日。 请注意，目前仅基于 Windows 的基于设备的订阅许可支持此属性。 如果不支持，则该值将设置为未知 (-1) 。 可能的值为：licenseRefreshStarted、、deviceIsNotAzureActiveDirectoryJoinedlicenseRefreshPending、acquiringDeviceLicensedeviceIdentityVerificationFailedrefreshingDeviceLicensemicrosoftAccountVerificationFailedverifyingMicrosoftDeviceIdentityverifyingMicrosoftAccountIdentity、deviceLicenseRefreshSucceed、deviceLicenseRefreshFailedremovingDeviceLicense、deviceLicenseRemoveSucceed、、deviceLicenseRemoveFailed、、unknownFutureValue、 。 unknown
deviceLicensingLastErrorCode Int32 指示最后一个错误的标准错误代码，或 0 表示没有错误 (默认) 。 此属性的更新频率为每日。 请注意，目前仅基于 Windows 的基于设备的订阅许可支持此属性。 有效值 0 到 2147483647
deviceLicensingLastErrorDescription String 作为 deviceLicensingLastErrorCode 的反加密的错误消息。 此属性的更新频率为每日。 请注意，目前仅基于 Windows 的基于设备的订阅许可支持此属性。

关系

无

JSON 表示形式

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

{
  "@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"
}
  • Last updated on