分享方式：

變更 Intune Data Warehouse API 的記錄

  • 文章

隨時掌握 Intune Data Warehouse的更新。

2202

發行于 2022 年 2 月

實體 applicationInventory 已從 Intune Data Warehouse中移除。 新的資料集現在可在 UI 和 Intune 的匯出 API 中使用。 如需相關資訊，請參閱 使用圖形 API 匯出 Intune 報表。

2105

發行于 2021 年 5 月

列 IntuneAosp 舉現在支援 managementAgentType 屬性值。 這個 ManagementAgentTypeID 屬性的值為 2048 。 它代表 Intune 的 MDM for AOSP (Android 開放原始碼專案) 裝置所管理的裝置類型。 如需相關資訊，請參閱 Intune Data Warehouse API 的 Beta 區段中的managementAgentType。

2103

發行于 2021 年 3 月

實體 applicationInventory 將會從 Intune Data Warehouse移除，並提供 2107 版的 Intune 更新。 我們引進了更完整且精確的資料集，可在 UI 和匯出 API 中使用。 如需相關資訊，請參閱 使用圖形 API 匯出 Intune 報表。

2007

發行于 2020 年 7 月

v1.0 變更

下表列出 Intune Data Warehouse中裝置實體的新增屬性。

集合 變更 描述資訊
ethernetMacAddress 添加 此裝置的唯一網路識別碼。
office365Version 添加 安裝在裝置上的 Microsoft 365 版本。

下表列出 Intune Data Warehouse中devicePropertyHistories實體的新增屬性。

集合 變更 描述資訊
physicalMemoryInBytes 添加 以位元組為單位的實體記憶體。
totalStorageSpaceInBytes 添加 儲存體容量總計，以位元組為單位。

2004

發行于 2020 年 4 月

v1.0 變更

下表列出 Intune Data Warehouse中devices實體的新增屬性。

集合 變更 描述資訊
windowsOsEdition 添加 Windows 作業系統版本。

Beta 變更

下表列出 Intune Data Warehouse中裝置實體的新增屬性。

集合 變更 描述資訊
windowsOsEdition 添加 Windows 作業系統版本。

2003

發行于 2020 年 3 月

Beta 變更

下表列出 Intune Data Warehouse中裝置實體的新增屬性。

集合 變更 描述資訊
ethernetMacAddress 添加 此裝置的唯一網路識別碼。
型號 添加 裝置型號。
office365Version 添加 安裝在裝置上的 Microsoft 365 版本。

下表列出 Intune Data Warehouse中devicePropertyHistory實體的新增屬性。

集合 變更 描述資訊
physicalMemoryInBytes 添加 以位元組為單位的實體記憶體。
totalStorageSpaceInBytes 添加 以位元組為單位的總儲存體。

第 2 部分 (1903)

發行于 2019 年 4 月

Beta 變更

下表列出 Intune Data Warehouse中最近移除的集合和取代集合。

集合 變更 其他資訊
mobileAppDeviceUserInstallStatus 已移除 請改用 mobileAppInstallStatusCounts 。
enrollmentTypes 已移除 請改用 deviceEnrollmentTypes 。
mdmStatuses 已移除 請改用 complianceStates 。
workPlaceJoinStateTypes 已移除 請改用 azureAdRegistered裝置 和 devicePropertyHistories 集合中的 屬性。
clientRegistrationStateTypes 已移除 請改用 deviceRegistrationStates 。
currentUser 已移除 請改用 users 集合。
mdmDeviceInventoryHistories 已移除 許多屬性都是備援屬性，現在可以在 devicePropertyHistories 或 裝置 集合中找到。 尚未與這兩個集合一起列出的任何 mdmDeviceInventoryHistories 屬性都無法再使用。 請參閱下方的詳細資料。

下表列出先前在 mdmDeviceInventoryHistories 集合中找到的舊屬性，以及變更/取代。 已移除 mdmDeviceInventoryHistories 中但未列于下方的任何屬性。

Old 屬性 變更/取代
cellularTechnology 裝置集合中的 cellularTechnology
deviceClientId 裝置集合中的 deviceId
deviceManufacturer 裝置集合中的製造商
deviceModel 裝置集合中的模型
deviceName 裝置集合中的 deviceName
deviceOsPlatform device 集合中的 deviceTypeKey
deviceOsVersion devicePropertyHistories 集合中的 osVersion
deviceType device 集合中的 deviceTypeKey，參考 deviceTypes 集合
encryptionState devices 集合中的 encryptionState 屬性
exchangeActiveSyncId devices 集合中的 easDeviceId 屬性
exchangeDeviceId 裝置集合中的 easDeviceId
Imei 裝置集合中的 imei
isSupervised 裝置集合中的 isSupervised 屬性
jailBroken devicePropertyHistories 集合中的 jailBroken
函式 devices 集合中的許可權屬性
Oem 裝置集合中的製造商
osName device 集合中的 deviceTypeKey，參考 deviceTypes 集合
phoneNumber 裝置集合中的 phoneNumber
platformType 裝置集合中的模型
產品 device 集合中的 deviceTypeKey
productVersion devicePropertyHistories 集合中的 osVersion
serialNumber devices 集合中的 serialNumber
storageFree devices 集合中的 freeStorageSpaceInBytes 屬性
storageTotal devices 集合中的 totalStorageSpaceInBytes 屬性
subscriberCarrierNetwork devices 集合中的 subscriberCarrier 屬性
wifimac 裝置集合中的 wiFiMacAddress

下表列出 devicePropertyHistories 集合中屬性的變更：

Old 屬性 變更/取代
categoryId deviceCategoryKey，參考 deviceCategories 集合
certExpirationDate 已移除
clientRegistrationStateKey deviceRegistrationStateKey
createdDate devices 集合中的 enrolledDateTime
deviceTypeKey device 集合中的 deviceTypeKey
easID 裝置集合中的 easDeviceId
enrolledByUser 裝置集合中的 userId
enrollmentTypeKey deviceEnrollmentTypeKey in devices collection
graphDeviceIsCompliant 已移除
graphDeviceIsManaged 已移除
lastContact devices 集合中的 lastSyncDateTime
lastContactNotification 已移除
lastContactWorkplaceJoin 已移除
lastExchangeStatusUtc 已移除
lastModifiedDateTimeUTC 已移除
lastPolicyUpdateUtc 已移除
managementAgentKey managementStateKey
製造商 裝置集合中的製造商
mdmStatusKey complianceStateKey，參考 complianceStates 集合
型號 裝置集合中的模型
osFamily 裝置集合中的 operatingSystem
osRevisionNumber 裝置集合中的 osVersion
processorArchitecture 已移除
referenceId 裝置集合中的 azureAdDeviceId
serialNumber devices 集合中的 serialNumber
workplaceJoinStateKey azureAdRegistered

下表列出 在 devices 集合中找到的屬性變更：

Old 屬性 變更/取代
categoryId deviceCategoryKey，參考 deviceCategories 集合
certExpirationDate 已移除
clientRegistrationStateKey deviceRegistrationStateKey
createdDate enrolledDateTime
easId easDeviceId
enrolledByUser userId
enrollmentTypeKey deviceEnrollmentTypeKey
graphDeviceIsCompliant 已移除
graphDeviceIsManaged 已移除
lastContact lastSyncDateTime
lastContactNotification 已移除
lastContactWorkplaceJoin 已移除
lastExchangeStatusUtc 已移除
lastPolicyUpdateUtc 已移除
mdmStatusKey complianceStateKey，參考 complianceStates 集合
osFamily operatingSystem
processorArchitecture 已移除
referenceId azureAdDeviceId
workplaceJoinStateKey azureAdRegistered

下表列出 enrollmentActivities 集合中屬性的變更：

Old 屬性 變更/取代
enrollmentTypeKey deviceEnrollmentTypeKey

下表列出 在 mamApplications 集合中找到的屬性變更：

Old 屬性 變更/取代
applicationKey mamApplicationKey
applicationName mamApplicationName
applicationId mamApplicationId

下表列出 在 mamApplicationInstances 集合中找到的屬性變更：

Old 屬性 變更/取代
applicationId mamApplicationId
deviceId mamDeviceId
deviceType mamDeviceType
deviceName mamDeviceName

下表列出 在 mamCheckins 集合中找到的屬性變更：

Old 屬性 變更/取代
applicationKey mamApplicationKey

下表列出 使用者 集合中屬性的變更：

Old 屬性 變更/取代
startDateInclusiveUtc 已移除
endDateInclusiveUtc 已移除
isCurrent 已移除

1903

發行于 2019 年 3 月

反映回 Beta 的 V1.0 變更

在 1808 年首次引進 V1.0 時，它與 Beta API 有一些顯著的差異。 在 1903 中，這些變更會反映回 Beta API 版本。 如果您有使用 Beta API 版本的重要報表，強烈建議您將這些報表切換至 V1.0，以避免中斷性變更。 如需Data Warehouse API版本和回溯相容性的詳細資訊，請參閱 API 版本資訊。

1902

發行于 2019 年 2 月

Power BI 合規性應用程式

使用 Intune 合規性 (Data Warehouse) 應用程式，在 Power BI Online中存取您的 Intune Data Warehouse。 使用此 Power BI 應用程式，您現在可以存取和共用預先建立的報表，而不需要任何設定，也不需要離開網頁瀏覽器。

注意事項

有兩個額外的篩選準則可套用至 Intune 合規性應用程式。

將其他篩選準則新增至 Intune 合規性應用程式

  1. 在網頁瀏覽器中開啟Intune 合規性 (Data Warehouse) 應用程式。
  2. 按一下[不符合規範的裝置]，然後在complianceStatus篩選中選取 [不符合規範]。
  3. 按一下[未知的裝置]，然後在complianceStatus篩選中選取 [尚無法使用]。

1812

發行于 2018 年 12 月

發行至 v1.0 的註冊活動集合

註冊活動集合現在可在 v1.0 中取得。 您可以使用此集合來瞭解您環境中的註冊失敗量和趨勢。 如需詳細資訊，請參閱 enrollmentActivities、 enrollmentEventStatuses、 enrollmentFailureCategories和 enrollmentFailureReasons。

1808

發行于 2018 年 8 月

v1.0 集合

您現在可以藉由設定查詢參數 api-version=v1.0 來使用 v1.0 版本的 Intune Data Warehouse。 匯報Data Warehouse中的集合本質上是加法的，而且不會中斷現有的案例。

發行至 Beta 的註冊活動集合

新的 Enrollment Activities 集合會發行為 Beta。 您可以藉由檢視最常見的失敗，使用此集合來瞭解註冊的進行方式。

1805

發行于 2018 年 5 月

修正 裝置集合 中的裝置計數

已修正 Devices 集合，這可能會降低依 屬性 isDeleted 篩選的總裝置計數。 此卸載是修正的結果，不是錯誤。 如需 裝置集合 的詳細資訊，請 參閱裝置實體的參考。

1801

發行于 2018 年 1 月

Intune Data Warehouse僅限應用程式驗證

您可以使用Microsoft Entra識別碼來設定應用程式，並向 Intune Data Warehouse進行驗證。 如需詳細資訊，請參閱Intune Data Warehouse僅限應用程式驗證。

Microsoft Entra識別碼和 Intune 認證需求

OData 查詢選項

您可以使用 $select 作為 OData 查詢參數。 目前的版本支援下列 OData 查詢參數： $filter 、 $orderby 、 $select 、 $skip 和 $top 。 如需詳細資訊，請參閱 OData 查詢選項。

Data Warehouse資料模型中 的新實體

  • 已新增實體 MobileAppDeviceuserInstallStatus。 MobileAppDeviceUserInstallStatus代表指定裝置和使用者的行動應用程式安裝狀態。
  • 已新增實體 MobileAppInstallStates。 MobileAppInstallState實體在指派給包含裝置、使用者或兩者的群組之後，代表行動應用程式的安裝狀態。

1710

發行于 2017 年 11 月

名為目前使用者的新實體集合僅限於目前作用中的使用者資料

Users實體集合包含企業中具有指派授權的所有Microsoft Entra使用者。 這些記錄包括資料收集期間的使用者狀態，即使使用者已移除也一般。 例如，使用者可能會新增至 Intune，然後在上個月的課程期間移除。 雖然此使用者在報表時不存在，但使用者和狀態會出現在資料中。 您可以建立報告，以顯示使用者在資料中的歷史存在持續時間。

相反地，新的 目前使用者 實體集合只包含尚未移除的使用者。 目前的 User實體集合只包含目前作用中的使用者。 如需 目前使用者 實體集合的相關資訊， 請參閱目前使用者實體的參考。

1709

發行于 2017 年 10 月

已新增至 Intune Data Warehouse資料模型的使用者裝置關聯實體集合

您現在可以使用關聯使用者和裝置實體集合的使用者裝置關聯資訊來建置報表和資料視覺效果。 您可以透過從 Data Warehouse Intune 頁面擷取的 Power BI 檔案 (PBIX) 、透過 OData 端點或開發自訂用戶端來存取資料模型。 如需詳細資訊，請參閱 使用者裝置關聯。

Data Warehouse資料模型中 的新實體

  • 已新增實體 UserDeviceAssociation。 UserDeviceAssociation 包含您組織中的使用者裝置關聯。 您現在可以使用關聯使用者和裝置實體集合的使用者裝置關聯資訊來建置報表和資料視覺效果。
  • 已新增實體 IntuneManagementExtension。 IntuneManagementExtension 包含行動裝置的實體，可追蹤版本和安裝狀態等資訊。

後續步驟