Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
API-beskrivning
Begränsa körningen av alla program på enheten förutom en fördefinierad uppsättning.
Begränsningar
Hastighetsbegränsningar för det här API:et är 100 anrop per minut och 1 500 anrop per timme.
Förhandskrav
- Den här åtgärden är tillgänglig för enheter på Windows 10, version 1709 eller senare och på Windows 11.
- Den här funktionen är tillgänglig om din organisation använder Microsoft Defender Antivirus.
- Den här åtgärden måste uppfylla kodintegritetsprincipformaten och signeringskraven för Windows Defender Application Control. Mer information finns i: Kodintegritetsprincipformat och signering.
Behörigheter
När du hämtar en token med användarautentiseringsuppgifter:
- Användaren måste ha minst följande rollbehörighet: "Aktiva reparationsåtgärder". Mer information finns i: Skapa och hantera roller.
- Användaren måste ha åtkomst till enheten baserat på enhetsgruppsinställningarna. Mer information finns i: Skapa och hantera enhetsgrupper.
En av följande behörigheter krävs för att anropa det här API:et. Mer information, inklusive hur du väljer behörigheter, finns i Använda Microsoft Defender för Endpoint-API:er
| Behörighetstyp | Behörighet | Visningsnamn för behörighet |
|---|---|---|
| Program | Machine.RestrictExecution | "Begränsa kodkörning" |
| Delegerat (arbets- eller skolkonto) | Machine.RestrictExecution | "Begränsa kodkörning" |
HTTP-begäran
POST https://api.security.microsoft.com/api/machines/{id}/restrictCodeExecution
Frågerubriker
| Namn | Typ | Beskrivning |
|---|---|---|
| Behörighet | Sträng | Ägaren {token}. Krävs. |
| Content-Type | sträng | application/json. Krävs. |
Frågebrödtext
I begärandetexten anger du ett JSON-objekt med följande parametrar:
| Parameter | Typ | Beskrivning |
|---|---|---|
| Kommentar | Sträng | Kommentar som ska associeras med åtgärden. Krävs. |
Svar
Om det lyckas returnerar den här metoden 201 – Skapad svarskod och Datoråtgärd i svarstexten.
Om du skickar flera API-anrop för att begränsa appkörningen för samma enhet returneras "väntande datoråtgärd" eller HTTP 400 med meddelandet "Åtgärden pågår redan".
Exempel
Begäran
Här är ett exempel på begäran.
POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/restrictCodeExecution
{
"Comment": "Restrict code execution due to alert 1234"
}