共用方式為

拿掉應用程式限制 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 執行機器動作。 如需透過 適用於端點的 Microsoft Defender 回應動作功能的詳細資訊，請參閱在計算機上採取回應動作。

重要事項

  • 完整隔離適用於 Windows 10 1703 版上的裝置。
  • 選擇性隔離適用於 Windows 10 版本 1709 或更新版本上的裝置。
  • 隔離裝置時，只允許特定進程和目的地。 因此，在隔離裝置之後，位於完整 VPN 通道後方的裝置將無法連線到 適用於端點的 Microsoft Defender 雲端服務。 我們建議針對 適用於端點的 Microsoft Defender 使用分割通道 VPN，並 Microsoft Defender 防病毒軟體雲端式保護相關流量。

權限

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

許可權類型 權限 許可權顯示名稱
應用程式 Machine.RestrictExecution '限制程式代碼執行'
委派 (公司或學校帳戶) Machine.RestrictExecution '限制程式代碼執行'

注意事項

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

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

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

HTTP 要求

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

要求標頭

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

要求內文

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

參數 Type 描述
留言 字串 要與動作相關聯的批注。 必要。

回應

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

如果您傳送多個 API 呼叫來移除相同裝置的應用程式限制，它會傳回「擱置中的機器動作」或 HTTP 400，並顯示「動作已在進行中」訊息。

範例

請求

以下是要求的範例。

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

{
  "Comment": "Unrestrict code execution since machine was cleaned and validated"
}

若要限制裝置上的程式碼執行，請參閱 限制應用程式執行。

提示

想要深入了解? Engage 技術社群中的Microsoft安全性社群：適用於端點的 Microsoft Defender 技術社群。