マシン リソースの種類

適用対象:

Microsoft Defender ATP を試してみたいですか? 無料試用版にサインアップしてください。

注:

米国政府機関のお客様の場合は、Microsoft Defender for Endpointに記載されている URI を米国政府機関のお客様に使用してください。

ヒント

パフォーマンスを向上させるために、地理的な場所に近いサーバーを使用できます。

  • api-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.com

重要

一部の情報は、市販される前に大幅に変更される可能性があるプレリリース製品に関するものです。 Microsoft は、ここに記載された情報に関して、明示または黙示を問わず、いかなる保証も行いません。

メソッド

メソッド 戻り値の型 説明
マシンの一覧表示 machine コレクション 組織内の マシン エンティティのセットを一覧表示します。
マシンを取得する マシン ID で コンピューター を取得します。
ログオンしているユーザーを取得する user コレクション コンピューターにログオンした ユーザー のセットを取得 します
関連するアラートを取得する alert コレクション コンピューターで発生した アラート エンティティのセットを取得 します
インストールされたソフトウェアを取得する ソフトウェア コレクション 特定のマシン ID に関連するインストール済みソフトウェアのコレクションを取得します。
検出された脆弱性を取得する 脆弱性の 収集 特定のマシン ID に関連する検出された脆弱性のコレクションを取得します。
セキュリティ上の推奨事項を取得する レコメンデーション コレクション 特定のマシン ID に関連するセキュリティに関する推奨事項のコレクションを取得します。
マシン タグの追加または削除 マシン 特定のコンピューターにタグを追加または削除します。
IP でマシンを検出する machine コレクション IP で見られるマシンを検索します。
タグでマシンを検出する machine コレクション タグでコンピューターを検索 します
不足している KB を取得する KB コレクション マシン ID に関連付けられている欠落している KB の一覧を取得する
デバイス値の設定 machine コレクション デバイスの値を設定します
コンピューターの更新 machine コレクション コンピューターの更新状態を取得します。

プロパティ

プロパティ 説明
id 文字列 マシン ID。
computerDnsName String マシン の完全修飾名。
firstSeen DateTimeOffset Microsoft Defender for Endpointによってマシンが観察された最初の日付と時刻。
lastSeen DateTimeOffset 最後に受信した完全なデバイス レポートの日時。 通常、デバイスは 24 時間ごとに完全なレポートを送信します。
osPlatform String オペレーティング システム プラットフォーム。
onboardingstatus 文字列 マシンオンボードの状態。 指定できる値は、"オンボード済み"、"CanBeOnboarded"、"サポートされていない"、"不十分な情報" です。
osProcessor 文字列 オペレーティング システム プロセッサ。 代わりに osArchitecture プロパティを使用します。
version 文字列 オペレーティング システムのバージョン。
osBuild Null 許容 long オペレーティング システムのビルド番号。
lastIpAddress 文字列 コンピューター上のローカル NIC の最後の IP。
lastExternalIpAddress 文字列 コンピューターがインターネットにアクセスした最後の IP。
healthStatus 列挙 マシン の正常性状態。 指定できる値は、"Active"、"Inactive"、"ImpairedCommunication"、"NoSensorData"、"NoSensorDataImpairedCommunication"、"Unknown" です。
rbacGroupName String マシン グループ名。
rbacGroupId 文字列 マシン グループ ID。
riskScore Null 許容列挙型 Microsoft Defender for Endpointによって評価されたリスク スコア。 指定できる値は、'None'、'Informational'、'Low'、'Medium'、'High' です。
aadDeviceId Null 許容表現 Guid AAD デバイス ID ( マシン が AAD Joined の場合)。
machineTags String collection マシン タグのセット。
exposureLevel Null 許容列挙型 Microsoft Defender for Endpointによって評価される露出レベル。 指定できる値は、'None'、'Low'、'Medium'、'High' です。
deviceValue Null 許容列挙型 デバイスの値。 指定できる値は、"Normal"、"Low"、"High" です。
ipAddresses IpAddress コレクション IpAddress オブジェクトのセット。 「 Get machines API」を参照してください。
osArchitecture 文字列 オペレーティング システムアーキテクチャ。 指定できる値は、"32 ビット"、"64 ビット" です。 osProcessor の代わりにこのプロパティを使用します。