デバイスウイルス対策の正常性の詳細 API のメソッドとプロパティをエクスポートする

デバイス ウイルス対策の正常性の詳細 API の説明をエクスポートする

Microsoft Defender ウイルス対策デバイスの正常性の詳細のリストを取得します。 この API には、さまざまな種類のデータを取得するための異なる API 呼び出し (メソッド) があります。 データの量は大きくなる可能性があるため、取得する方法は 2 つあります。

• JSONAPI は、organization内のすべてのデータを JSON 応答としてプルします。 この方法は、 100 K 未満のデバイスを持つ小規模な組織に最適です。 応答はページ分割されるため、応答の@odata.nextLink フィールドを使用して、次の結果をフェッチできます。

• ファイル この API ソリューションを使用すると、大量のデータをより迅速かつ確実にプルでき、100,000 を超えるデバイスを持つ大規模な組織に推奨されます。 この API は、組織内のすべてのデータをダウンロード ファイルとしてプルします。 応答には、Azure Storage からすべてのデータをダウンロードするための URL が含まれています。 この API を使用すると、次のように Azure Storage からすべてのデータをダウンロードできます:

  1. すべての組織データを含むダウンロード URL の一覧を取得するには、API を呼び出します。

  2. ダウンロード URL を使用してすべてのファイルをダウンロードし、データを好きなように処理します。

JSON responseまたはファイルを使用して収集されるデータは、現在の状態のスナップショットです。 このデータには履歴データは含まれません。 履歴データを収集するには、データを独自のデータ ストレージに保存する必要があります。

Microsoft Defender ポータルでデバイスの正常性とウイルス対策コンプライアンス レポート ツールを使用する方法については、「Microsoft Defender for Endpointのデバイスの正常性とウイルス対策レポート」を参照してください。

前提条件

• Windows Server 2012 R2 とWindows Server 2016をデバイス正常性レポートに表示するには、最新の統合ソリューション パッケージを使用してこれらのデバイスをオンボードする必要があります。 詳細については、「Windows Server 2012 R2 と 2016 の最新の統合ソリューションの新機能」を参照してください。

1.1 デバイスウイルス対策正常性の詳細 API メソッドをエクスポートする

1.2 制限事項

• 最大ページ サイズ: 200,000
• この API のレート制限: 1 分あたり 30 呼び出し、1 時間あたり 1,000 呼び出し

1.3 デバイスウイルス対策の正常性の詳細 API プロパティのエクスポート (JSON 応答)

• 次のテーブルで定義されているプロパティは、プロパティ ID でアルファベット順にリスト表示されます。 この API を使用する場合、結果の出力は必ずしもこの表に記載されている順序で返されるとは限りません。
• rbacgroupname と ID は、フィルター演算子としてサポートされていないことに注意してください。
• 応答でさらに列が返される場合があります。 これらの列は一時的な場合があり、削除される場合があります。は、文書化された列のみを使用します。

1.4 デバイスウイルス対策の正常性の詳細 API プロパティをエクスポートする (ファイル経由)

各エクスポート ファイルには、ウイルス対策データを含む DeviceGatheredInfo というプロパティがあります。 各属性は、デバイスの正常性とその状態に関する情報を提供できます。

• ファイルは gzip 圧縮され、複数行 .json 形式です。
• ダウンロード URL は 3 時間だけ有効です。それ以外の場合は、パラメーターを使用できます。
• データの最大ダウンロード速度を得るために、データが存在するのと同じAzureリージョンからダウンロードしていることを確認できます。
• 各レコードでは、約 1 KB のデータが使用されます。 正しい pageSize パラメーターを選択する場合は、これを考慮する必要があります。
• 応答でさらに多くの列が返される場合があります。 これらの列は一時的であり、削除される可能性があるため、文書化されている列のみを使用してください。