API 描述
限制裝置上除預設集合外的所有應用程式執行。
限制
此 API 的速率限制為每分鐘 100 次呼叫及每小時 1500 次呼叫。
必要條件
- 此動作適用於 Windows 10、版本 1709 或更新版本，以及 Windows 11 上的裝置。
- 此功能適用於貴組織使用 Microsoft Defender 防毒軟體。
- 此動作需符合 Windows Defender 應用程式控制碼完整性政策格式及簽約要求。 欲了解更多資訊，請參閱： 程式碼完整性政策格式與簽署。
權限
使用使用者憑證取得令牌時：
呼叫此 API 需要以下其中一項權限。 欲了解更多，包括如何選擇權限，請參閱「使用適用於端點的 Microsoft Defender APIS」
| 權限類型 | 權限 | 權限顯示名稱 |
|---|---|---|
| 應用程式 | Machine.RestrictExecution | 「限制程式碼執行」 |
| 委託 (工作或學校帳戶) | Machine.RestrictExecution | 「限制程式碼執行」 |
HTTP 要求
POST https://api.security.microsoft.com/api/machines/{id}/restrictCodeExecution
要求標頭
| 名稱 | 類型 | 描述 |
|---|---|---|
| 授權 | 字串 | 持有人 {token}。 必要。 |
| Content-Type | 字串 | application/json。 必要。 |
要求內文
在請求主體中，提供一個包含以下參數的 JSON 物件：
| 參數 | Type | 描述 |
|---|---|---|
| 留言 | 字串 | 留言以與行動相關聯。 必要。 |
回應
若成功，此方法會在回應體中回傳 201 - 已建立的回應程式碼與 機器動作 。
如果你發送多個 API 呼叫來限制同一裝置的應用程式執行，它會回傳「待處理機器動作」或 HTTP 400，並顯示「動作已進行中」。
範例
請求
以下是該請求的範例。
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/restrictCodeExecution
{
"Comment": "Restrict code execution due to alert 1234"
}