インストールされたソフトウェアを取得する

重要

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

特定のデバイス ID に関連するインストール済みソフトウェアのコレクションを取得します。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法など、詳細については、「Microsoft Defender for Endpoint API を使用する」を参照してください。

アクセス許可の種類 アクセス許可 アクセス許可の表示名
アプリケーション Software.Read.All '脅威と脆弱性管理ソフトウェア情報の読み取り'
委任 (職場または学校のアカウント) Software.Read '脅威と脆弱性管理ソフトウェア情報の読み取り'

HTTP 要求

GET /api/machines/{machineId}/software

要求ヘッダー

名前 説明
Authorization String ベアラー {token}。 必須

要求本文

Empty

応答

成功した場合、このメソッドは、本体にインストールされているソフトウェア情報を含む 200 OK を返します。

要求の例

以下は、要求の例です。

GET https://api.security.microsoft.com/api/machines/ac233fa6208e1579620bf44207c4006ed7cc4501/software

応答の例

応答の例を下に示します。

{
"@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
"value": [
        {
"id": "microsoft-_-internet_explorer",
"name": "internet_explorer",
"vendor": "microsoft",
"weaknesses": 67,
"publicExploit": true,
"activeAlert": false,
"exposedMachines": 42115,
"impactScore": 46.2037163
        }
    ]
}