---
title: Ausführen der Antivirus-Scan-API
description: Verwenden Sie diese API, um Aufrufe im Zusammenhang mit der Ausführung eines Antivirenscans auf einem Gerät zu erstellen.
keywords: APIs, Graph-API, unterstützte APIs, Gerät aus Isolation entfernen
search.product: eADQiWindows 10XVcnh
ms.prod: m365-security
ms.mktglfcycl: deploy
ms.sitesec: library
ms.pagetype: security
ms.author: macapara
author: mjcaparas
ms.localizationpriority: medium
manager: dansimp
audience: ITPro
ms.collection: M365-security-compliance
ms.topic: article
MS.technology: mde
ms.custom: api
ms.openlocfilehash: df66a35cdce846ba9ca00e323f7c78e7d4d0ee73
ms.sourcegitcommit: d4b867e37bf741528ded7fb289e4f6847228d2c5
ms.translationtype: MT
ms.contentlocale: de-DE
ms.lasthandoff: 10/06/2021
ms.locfileid: "60203999"
---
# <a name="run-antivirus-scan-api"></a>Ausführen der Antivirus-Scan-API
[!INCLUDE [Microsoft 365 Defender rebranding](../../includes/microsoft-defender.md)]
**Gilt für:** [Microsoft Defender für Endpunkt](https://go.microsoft.com/fwlink/?linkid=2154037)
- Möchten Sie Microsoft Defender für Endpunkt ausprobieren? [Registrieren Sie sich für eine kostenlose Testversion](https://signup.microsoft.com/create-account/signup?products=7f379fee-c4f9-4278-b0a1-e4c8c2fcdf7e&ru=https://aka.ms/MDEp2OpenTrial?ocid=docs-wdatp-exposedapis-abovefoldlink).
[!include[Microsoft Defender for Endpoint API URIs for US Government](../../includes/microsoft-defender-api-usgov.md)]
[!include[Improve request performance](../../includes/improve-request-performance.md)]
## <a name="api-description"></a>API-Beschreibung
Initiieren sie Microsoft Defender Antivirus Überprüfung auf einem Gerät.
## <a name="limitations"></a>Einschränkungen
1. Die Rateneinschränkungen für diese API liegen bei 100 Aufrufen pro Minute und 1500 Aufrufen pro Stunde.
[!include[Device actions note](../../includes/machineactionsnote.md)]
> [!IMPORTANT]
>
> - Diese Aktion ist für Geräte mit Windows 10, Version 1709 oder höher, verfügbar.
> - Ein Microsoft Defender Antivirus (Microsoft Defender AV)-Scan kann zusammen mit anderen Antivirenlösungen ausgeführt werden, unabhängig davon, ob Microsoft Defender Antivirus die aktive Antivirenlösung ist oder nicht. Microsoft Defender Antivirus können sich im passiven Modus befinden. Weitere Informationen finden Sie unter [Microsoft Defender Antivirus Kompatibilität.](/windows/security/threat-protection/microsoft-defender-antivirus/microsoft-defender-antivirus-compatibility.md)
## <a name="permissions"></a>Berechtigungen
Eine der folgenden Berechtigungen ist erforderlich, um diese API aufzurufen. Weitere Informationen, einschließlich der Auswahl von Berechtigungen, finden Sie unter [Verwenden von Microsoft Defender für Endpunkt-APIs](apis-intro.md)
Berechtigungstyp|Berechtigung|Anzeigename der Berechtigung
:---|:---|:---
Anwendung|Machine.Scan|"Scancomputer"
Delegiert (Geschäfts-, Schul- oder Unikonto)|Machine.Scan|"Scancomputer"
> [!NOTE]
> Beim Abrufen eines Tokens mithilfe von Benutzeranmeldeinformationen:
>
> - Der Benutzer muss mindestens über die folgende Rollenberechtigung verfügen: "Aktive Korrekturaktionen" (Weitere Informationen finden Sie unter ["Erstellen und Verwalten von Rollen")](user-roles.md)
> - Der Benutzer muss basierend auf den Gerätegruppeneinstellungen Zugriff auf das Gerät haben (Weitere Informationen finden Sie unter [Erstellen und Verwalten von Gerätegruppen).](machine-groups.md)
## <a name="http-request"></a>HTTP-Anforderung
```http
POST https://api.securitycenter.microsoft.com/api/machines/{id}/runAntiVirusScan
```
## <a name="request-headers"></a>Anforderungsheader
Name|Typ|Beschreibung
:---|:---|:---
Authorization|Zeichenfolge|Bearer {token}. **Erforderlich**.
Content-Type|string|application/json
## <a name="request-body"></a>Anforderungstext
Geben Sie im Anforderungstext ein JSON-Objekt mit den folgenden Parametern an:
Parameter|Typ|Beschreibung
:---|:---|:---
Kommentar|Zeichenfolge|Kommentar, der der Aktion zugeordnet werden soll. **Erforderlich**.
ScanType|Zeichenfolge|Definiert den Typ des Scans. **Erforderlich**.
**ScanType** steuert den typ des durchzuführenden Scans und kann eine der folgenden Sein:
- **Schnell:** Durchführen eines Schnellscans auf dem Gerät
- **Vollständig:** Vollständige Überprüfung auf dem Gerät durchführen
## <a name="response"></a>Antwort
Wenn die Methode erfolgreich ist, werden der Antwortcode "201" und das MachineAction-Objekt im Antworttext zurückgegeben. 
Wenn Sie mehrere API-Aufrufe senden, um eine Antivirenüberprüfung für dasselbe Gerät auszuführen, wird "Ausstehende Computeraktion" oder HTTP 400 mit der Meldung "Aktion ist bereits ausgeführt" zurückgegeben.
## <a name="example"></a>Beispiel
### <a name="request"></a>Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
```http
POST https://api.securitycenter.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/runAntiVirusScan 
```
```json
{
  "Comment": "Check machine for viruses due to alert 3212",
  "ScanType": "Full"
}
```