共用方式為

停止和隔離檔案 API

  • 發行項

適用於：

想要體驗適用於端點的 Microsoft Defender 嗎？ 注册免費試用版。

注意事項

如果您是美國政府客戶，請使用 適用於美國政府客戶的 Microsoft Defender 中所列的 URI。

提示

為了獲得更好的效能，您可以使用更接近您地理位置的伺服器：

  • us.api.security.microsoft.com
  • eu.api.security.microsoft.com
  • uk.api.security.microsoft.com
  • au.api.security.microsoft.com
  • swa.api.security.microsoft.com
  • ina.api.security.microsoft.com

API 描述

停止在裝置上執行檔案並將其刪除。

限制

  1. 此 API 的速率限制為每分鐘 100 次呼叫，每小時 1500 次呼叫。

注意事項

此頁面著重於透過 API 執行機器動作。 如需透過適用於端點的Defender Microsoft回應動作功能的詳細資訊，請參閱在 電腦上採取回應動作 。

重要事項

您只能在下列情況採取此動作：

  • 您要採取動作的裝置正在執行 Windows 10 版本 1703 或更新版本，或 Windows 11
  • 檔案不屬於受信任的第三方發行者，或不是由Microsoft
  • Microsoft Defender 防病毒軟體至少必須在被動模式下執行。 如需詳細資訊， 請參閱 Microsoft Defender 防病毒軟體相容性。

權限

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

許可權類型 權限 許可權顯示名稱
應用程式 Machine.StopAndQuarantine 'Stop and Quarantine'
應用程式 Machine.Read.All 「讀取所有計算機設定檔」
應用程式 Machine.ReadWrite.All 「讀取和寫入所有機器資訊」
委派 (公司或學校帳戶) Machine.StopAndQuarantine 'Stop and Quarantine'

注意事項

使用使用者認證取得權杖時：

  • 使用者至少必須具有下列角色許可權：[主動補救動作] (如需詳細資訊，請參閱 建立和管理角色)
  • 用戶必須根據裝置群組設定來存取裝置 (如需詳細資訊，請參閱 建立和管理裝置群組)

適用於端點的Defender方案1和方案2支援裝置群組建立。

HTTP 要求

POST https://api.securitycenter.microsoft.com/api/machines/{id}/StopAndQuarantineFile

要求標頭

名稱 類型 描述
授權 字串 持有人 {token}。 必要。
Content-Type 字串 application/json。 必要。

要求內文

在要求本文中，提供具有下列參數的 JSON 物件：

參數 Type 描述
留言 字串 要與動作相關聯的批注。 必要。
Sha1 字串 要在裝置上停止和隔離之檔案的 Sha1。 必要。

回應

如果成功，這個方法會傳回響應主體中的 201 - 建立的響應碼和 機器動作 。

範例

請求

以下是要求的範例。

POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/StopAndQuarantineFile 

{
  "Comment": "Stop and quarantine file on machine due to alert 441688558380765161_2136280442",
  "Sha1": "87662bc3d60e4200ceaf7aae249d1c343f4b83c9"
}

提示

想要深入了解? 在我們的技術社群中與Microsoft安全性社群互動：Microsoft適用於端點的Defender技術社群。