Intune Data Warehouse API のログを変更する

  • [アーティクル]

Intune Data Warehouseの更新プログラムを最新の状態に保ちます。

2202

リリース日: 2022 年 2 月

applicationInventoryエンティティが Intune Data Warehouseから削除されました。 UI と Intune のエクスポート API を使用して、新しいデータセットを使用できるようになりました。 関連情報については、「Graph API を使用して Intune レポートをエクスポートする」を参照してください。

2105

リリース日: 2021 年 5 月

managementAgentType 列挙型で IntuneAosp プロパティ値がサポートされるようになりました。 このプロパティの ManagementAgentTypeID 値は 2048 です。 これは、Intune の AOSP (Android オープン ソース プロジェクト) デバイス用 MDM で管理されるデバイスの種類を表します。 関連情報については、Intune データ ウェアハウス API のベータ セクションの「managementAgentType」を参照してください。

2103

リリース日: 2021 年 3 月

エンティティはapplicationInventory、Intune の 2107 更新プログラムを使用して Intune Data Warehouseから削除されます。 UI とエクスポート API を使用して使用できる、より完全で正確なデータセットを導入しています。 関連情報については、「Graph 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 オペレーティング システム エディション。

ベータ版の変更

次の表に、Intune Data Warehouseのデバイス エンティティに追加されたプロパティの一覧を示します。

コレクション 変更 説明情報
windowsOsEdition 追加 Windows オペレーティング システム エディション。

2003

リリース日: 2020 年 3 月

ベータ版の変更

次の表に、Intune Data Warehouseのデバイス エンティティに追加されたプロパティの一覧を示します。

コレクション 変更 説明情報
ethernetMacAddress 追加 このデバイスの一意のネットワーク識別子。
model 追加 デバイス モデル。
office365Version 追加 デバイスにインストールされている Microsoft 365 のバージョン。

次の表は、Intune Data Warehouseの devicePropertyHistory エンティティに追加されたプロパティの一覧です。

コレクション 変更 説明情報
physicalMemoryInBytes 追加 物理メモリ (バイト単位)。
totalStorageSpaceInBytes 追加 ストレージの合計 (バイト単位)。

1903 (パート 2)

リリース日: 2019 年 4 月

ベータ版の変更

次の表に、Intune Data Warehouseで最近削除されたコレクションと置換コレクションの一覧を示します。

コレクション 変更 追加情報
mobileAppDeviceUserInstallStatus 削除 代わりに mobileAppInstallStatusCounts を 使用します。
enrollmentTypes 削除 代わりに deviceEnrollmentTypes を 使用します。
mdmStatuses 削除 代わりに complianceStates を 使用します。
workPlaceJoinStateTypes 削除 代わりに、azureAdRegisteredデバイスと devicePropertyHistories コレクションの プロパティを使用します。
clientRegistrationStateTypes 削除 代わりに deviceRegistrationStates を 使用します。
currentUser 削除 代わりに users コレクションを使用してください。
mdmDeviceInventoryHistories 削除 プロパティの多くは冗長であったか、 devicePropertyHistories または devices コレクションにあります。 これら 2 つのコレクションにまだ一覧表示されていない mdmDeviceInventoryHistories プロパティは使用できなくなりました。 以下の詳細を参照してください。

次の表は、 mdmDeviceInventoryHistories コレクションで以前に見つかった古いプロパティと、変更/置換の一覧です。 mdmDeviceInventoryHistories に含まれるが、以下に記載されていないプロパティはすべて削除されています。

Old プロパティ 変更/置換
cellularTechnology デバイス コレクションの cellularTechnology
deviceClientId デバイス コレクション内の deviceId
deviceManufacturer デバイス コレクションの製造元
deviceModel デバイス コレクション内のモデル
deviceName devices コレクション内の deviceName
deviceOsPlatform devices コレクション内の deviceTypeKey
deviceOsVersion devicePropertyHistories コレクションの osVersion
deviceType deviceTypes コレクションを参照するデバイス コレクション内の deviceTypeKey
encryptionState devices コレクション内の encryptionState プロパティ
exchangeActiveSyncId デバイス コレクションの easDeviceId プロパティ
exchangeDeviceId デバイス コレクション内の easDeviceId
imei デバイス コレクションの imei
isSupervised devices コレクション内の isSupervised プロパティ
jailBroken devicePropertyHistories コレクションの jailBroken
meid devices コレクションの meid プロパティ
Oem デバイス コレクションの製造元
osName deviceTypes コレクションを参照するデバイス コレクション内の deviceTypeKey
phoneNumber デバイス コレクション内の phoneNumber
platformType デバイス コレクション内のモデル
製品 devices コレクション内の deviceTypeKey
productVersion devicePropertyHistories コレクションの osVersion
シリアル番号 デバイス コレクション内の serialNumber
storageFree devices コレクション内の freeStorageSpaceInBytes プロパティ
storageTotal devices コレクション内の totalStorageSpaceInBytes プロパティ
subscriberCarrierNetwork devices コレクションの subscriberCarrier プロパティ
wifimac デバイス コレクションの wiFiMacAddress

次の表に、 devicePropertyHistories コレクションにあるプロパティの変更を示します。

Old プロパティ 変更/置換
Categoryid deviceCategoryKey、deviceCategories コレクションの参照
certExpirationDate 削除
clientRegistrationStateKey deviceRegistrationStateKey
createdDate デバイス コレクションの enrolledDateTime
deviceTypeKey devices コレクション内の deviceTypeKey
easID デバイス コレクション内の easDeviceId
enrolledByUser デバイス コレクション内の userId
enrollmentTypeKey devices コレクション内の deviceEnrollmentTypeKey
graphDeviceIsCompliant 削除
graphDeviceIsManaged 削除
lastContact デバイス コレクションの lastSyncDateTime
lastContactNotification 削除
lastContactWorkplaceJoin 削除
lastExchangeStatusUtc 削除
lastModifiedDateTimeUTC 削除
lastPolicyUpdateUtc 削除
managementAgentKey managementStateKey
manufacturer デバイス コレクションの製造元
mdmStatusKey complianceStateKey、complianceStates コレクションを参照する
model デバイス コレクション内のモデル
osFamily operatingSystem in devices collection
osRevisionNumber デバイス コレクションの osVersion
processorArchitecture 削除
referenceId デバイス コレクション内の azureAdDeviceId
シリアル番号 デバイス コレクション内の 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

次の表に、 users コレクションにあるプロパティの変更を示します。

Old プロパティ 変更/置換
startDateInclusiveUtc 削除
endDateInclusiveUtc 削除
isCurrent 削除

1903

リリース日: 2019 年 3 月

ベータ版に戻る V1.0 の変更

V1.0 が 1808 年に初めて導入されたとき、ベータ API とは大きく異なっていました。 1903 年には、これらの変更がベータ API バージョンに反映されます。 ベータ API バージョンを使用する重要なレポートがある場合は、破壊的変更を避けるために、これらのレポートを V1.0 に切り替えることを強くお勧めします。 DATA WAREHOUSE API のバージョンと下位互換性の詳細については、API のバージョン情報を参照してください。

1902

リリース日: 2019 年 2 月

Power BI コンプライアンス アプリ

Intune コンプライアンス (Data Warehouse) アプリを使用して、Power BI Online で Intune Data Warehouseにアクセスします。 この Power BI アプリを使用すると、事前に作成されたレポートにアクセスし、Web ブラウザーを離れることなく、セットアップなしで共有できるようになりました。

注:

Intune コンプライアンス アプリに適用できるフィルターは 2 つあります。

Intune コンプライアンス アプリにフィルターを追加する

  1. Web ブラウザーで 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内のコレクションへの更新は本質的に付加的であり、既存のシナリオを損ないません。

ベータ版にリリースされた登録アクティビティ コレクション

新しい Enrollment Activities コレクションはベータ版にリリースされます。 このコレクションを使用すると、最も一般的なエラーを表示して、登録の進み方を理解できます。

1805

リリース日: 2018 年 5 月

デバイス コレクションのデバイス数の修正

Devices コレクションが修正されました。これにより、 属性isDeletedによってフィルター処理されるデバイスの合計数が減少する可能性があります。 このドロップは修正の結果であり、エラーではありません。 Devices コレクションの詳細については、「デバイス エンティティのリファレンス」を参照してください。

1801

リリース日: 2018 年 1 月

Intune Data Warehouseアプリケーション専用認証

Microsoft Entra ID を使用してアプリケーションを設定し、Intune Data Warehouseに対する認証を行うことができます。 詳細については、「Intune Data Warehouseアプリケーション専用認証」を参照してください。

Microsoft Entra ID と Intune 資格情報の要件

  • Intune Data Warehouse (API を含む) にアクセスするときに、Intune ライセンスをユーザーに割り当てる必要がなくなりました。

  • Intune ロール名が レポート から Intune データ ウェアハウスに変更されました。

    詳細については、「Microsoft Entra ID と Intune 資格情報の要件」を参照してください。

OData クエリ オプション

OData クエリ パラメーターとしてを使用 $select できます。 現在のバージョンでは、次の OData クエリ パラメーター $filter、、$orderby$select$skipおよび がサポートされています$top。 詳細については、「 OData クエリ オプション」を参照してください。

Data Warehouse データ モデル内の 新しいエンティティ

  • エンティティ MobileAppDeviceuserInstallStatus が追加されました。 MobileAppDeviceUserInstallStatus は、特定のデバイスとユーザーのモバイル アプリのインストール状態を表します。
  • エンティティ MobileAppInstallStates が追加されました。 MobileAppInstallState エンティティは、デバイス、ユーザー、またはその両方を含むグループに割り当てられた後のモバイル アプリケーションのインストール状態を表します。

1710

リリース日: 2017 年 11 月

Current User という名前の新しいエンティティ コレクションは、現在アクティブなユーザー データに制限されます

Users エンティティ コレクションには、エンタープライズでライセンスが割り当てられているすべてのMicrosoft Entra ユーザーが含まれています。 これらのレコードには、ユーザーが削除された場合でも、データ収集期間中のユーザー状態が含まれます。 たとえば、ユーザーが Intune に追加された後、先月の間に削除される場合があります。 このユーザーはレポートの時点では存在しませんが、ユーザーと状態はデータに存在します。 データ内のユーザーの過去のプレゼンスの期間を示すレポートを作成できます。

これに対し、新しい Current User エンティティ コレクションには、削除されていないユーザーのみが含まれます。 Current User エンティティ コレクションには、現在アクティブなユーザーのみが含まれています。 現在のユーザー エンティティ コレクションの詳細については、「現在のユーザー エンティティのリファレンス」を参照してください。

1709

リリース日: 2017 年 10 月

Intune Data Warehouse データ モデルに追加されたユーザー デバイス関連付けエンティティ コレクション

ユーザーエンティティコレクションとデバイスエンティティコレクションを関連付けるユーザーデバイス関連付け情報を使用して、レポートとデータの視覚化を構築できるようになりました。 データ モデルには、Data Warehouse Intune ページから取得した Power BI ファイル (PBIX)、OData エンドポイント、またはカスタム クライアントを開発することでアクセスできます。 詳細については、「 ユーザー デバイスの関連付け」を参照してください。

Data Warehouse データ モデル内の 新しいエンティティ

  • エンティティ UserDeviceAssociation が追加されました。 UserDeviceAssociation には、organizationにユーザー デバイスの関連付けが含まれています。 ユーザーエンティティコレクションとデバイスエンティティコレクションを関連付けるユーザーデバイス関連付け情報を使用して、レポートとデータの視覚化を構築できるようになりました。
  • エンティティ IntuneManagementExtension が追加されました。 IntuneManagementExtension には、バージョンやインストール状態などの情報を追跡するモバイル デバイスのエンティティが含まれています。

次の手順