匯出每個裝置的瀏覽器擴充功能評量

適用於：

• 適用於端點的 Microsoft Defender 方案 1
• 適用於端點的 Microsoft Defender 方案 2
• Microsoft Defender 弱點管理
• Microsoft Defender XDR

想要體驗適用於端點的 Microsoft Defender 嗎？ 註冊免費試用。。

想要體驗 Microsoft Defender 弱點管理 嗎？ 深入瞭解如何註冊 Microsoft Defender 弱點管理 公開預覽試用版。

傳回所有已知已安裝的瀏覽器擴充功能及其所有裝置的詳細數據，以每個裝置為基礎。

不同的 API 呼叫會取得不同類型的數據。 因為數據量可能很大，所以有兩種方式可以擷取：

• 匯出瀏覽器擴充功能評估 JSON 回應 API 會將組織中的所有數據提取為 Json 回應。 此方法最適合 裝置少於 100 K 的小型組織。 回應會進行分頁，因此您可以使用回應中的 @odata.nextLink 欄位來擷取下一個結果。

• 透過檔案匯出瀏覽器延伸模組評量此 API 解決方案可讓您更快速且更可靠地提取大量數據。 對於具有超過 100 K 裝置的大型組織，建議使用此選項。 此 API 會將組織中的所有資料提取為下載檔。 回應包含可從 Azure 記憶體下載所有數據的 URL。 此 API 可讓您從 Azure 記憶體下載所有資料，如下所示：

  • 呼叫 API 以取得包含您所有組織資料的下載 URL 清單。
  • 使用下載 URL 下載所有檔案，並視需要處理數據。

使用 Json 回應 或透過 檔案) 收集 (的數據是目前狀態的目前快照集。 它不包含歷史數據。 若要收集歷史數據，客戶必須將數據儲存在自己的數據記憶體中。

1.導出瀏覽器延伸模組評量 (JSON 回應)

1.1 API 方法描述

此 API 回應包含每個裝置已安裝之瀏覽器擴充功能的所有數據。 傳回數據表，其中包含 DeviceId、BrowserName、ExtensionId 之每個唯一組合的專案。

1.1.1 限制

• 頁面大小上限為 200,000。
• 此 API 的速率限制為每分鐘 30 次呼叫，每小時 1,000 次呼叫。

1.2 許可權

呼叫此 API 需要下列其中一個許可權。 若要深入瞭解，包括如何選擇許可權，請參閱使用 適用於端點的 Microsoft Defender API 以取得詳細數據。

1.3 URL

GET /api/Machines/BrowserExtensionsInventoryByMachine

1.4 參數

• pageSize (預設值 = 50,000) ：回應中的結果數目。
• $top：要傳回的結果數目 (不會傳回 @odata.nextLink ，因此不會提取所有數據)

1.5 屬性

1.6 範例

1.6.1 要求範例

GET https://api.securitycenter.microsoft.com/api/Machines/BrowserExtensionsInventoryByMachine?pageSize=5  &sinceTime=2021-05-19T18%3A35%3A49.924Z

1.6.2 回應範例

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Collection(contoso.windowsDefenderATP.api.AssetSoftware)",
    "value": [
        {
            "DeviceId": "1c32162b42e9efa1f5de42f951775f22f435c997",
            "DeviceName": "computerpii_1363c2e016e2225cb03974df58f14e6968067aa8.domainpii_f260e982985f7e8eee198b4332e0ae5b2a069cd6.corp.microsoft.com",
            "RbacGroupId": 86,
            "RbacGroupName": "UnassignedGroup",
            "InstallationTime": "2022-05-26T18:46:27.000Z",
            "BrowserName": "chrome",
            "ExtensionId": "dkpejdfnpdkhifgbancbammdijojoffk",
            "ExtensionName": "Logitech Smooth Scrolling",
            "ExtensionDescription": "Buttery-smooth scrolling for Logitech mice and touchpads.",
            "ExtensionVersion": "6.65.62",
            "ExtensionRisk": "High",
            "IsActivated": true,
            "Permissions": [
                        {
                                    "Id": "tabs",
                                    "IsRequired": true,
                                    "Risk": "High"
                        },
                        {
                                    "Id": http://*/*,
                                    "IsRequired": true,
                                    "Risk": "High"
                        },
                        {
                                    "Id": https://*/*,
                                    "IsRequired": true,
                                    "Risk": "High"
                        }
            ]
}
    ],
    "@odata.nextLink": "https://api.securitycenter.microsoft.com/api/Machines/BrowserExtensionsInventoryByMachine?pagesize=5&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMS0wMS0yNS8wMjAwLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}

2.透過檔案導出瀏覽器擴充 (評定)

2.1 API 方法描述

此 API 回應包含每個裝置已安裝之瀏覽器擴充功能的所有數據。 傳回數據表，其中包含 DeviceId、BrowserName、ExtensionId 之每個唯一組合的專案。

2.1.1 限制

此 API 的速率限制為每分鐘 5 次呼叫，每小時 20 次呼叫。

2.2 許可權

呼叫此 API 需要下列其中一個許可權。 若要深入瞭解，包括如何選擇許可權，請參閱使用 適用於端點的 Microsoft Defender API 以取得詳細數據。

2.3 URL

GET /api/machines/browserextensionsinventoryExport

2.4 屬性

2.6 範例

2.6.1 要求範例

GET https://api.securitycenter.microsoft.com/api/machines/browserextensionsinventoryExport

2.6.2 回應範例

{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.ExportFilesResponse",
    "exportFiles": [
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/BrowserExtensions/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/BrowserExtensions/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
        "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/BrowserExtensions/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c001.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=..."
    ],
    "generatedTime": "2021-01-11T11:01:00Z"
}

另請參閱

• 取得瀏覽器擴充功能許可權資訊
• 瀏覽器擴充功能評定

其他相關

• 弱點管理
• 組織中的弱點