Auflisten aller Bewertungsprofile für Sicherheitsbaselines

Gilt für:

• Microsoft Defender für Endpunkt Plan 1
• Microsoft Defender für Endpunkt Plan 2
• Microsoft Defender Sicherheitsrisikomanagement
• Microsoft Defender XDR

Möchten Sie Microsoft Defender Vulnerability Management erleben? Erfahren Sie mehr darüber, wie Sie sich für die Microsoft Defender Vulnerability Management öffentliche Vorschauversion registrieren können.

1. Abrufen von Bewertungsprofilen für Sicherheitsbaselines

Diese API ruft eine Liste aller Bewertungsprofile für Sicherheitsbaselines ab, die vom organization erstellt wurden.

1.1 Parameter

• Unterstützt OData V4-Abfragen.
• OData-unterstützte Operatoren:
  • $filter auf: id,name, operatingSystem, operatingSystemVersion, status, settingsNumber, passedDevices, totalDevices
  • $top mit einem Höchstwert von 10.000.
  • $skip.

1.2 HTTP-Anforderung

GET:/api/baselineProfiles

1.3 Anforderungsheader

Name	Typ	Beschreibung
Authorization	String	Bearer {token}. Erforderlich.

1.4 Eigenschaften

Eigenschaft	Typ	Beschreibung
Id	String	Eindeutiger Bezeichner für das bestimmte Baselineprofil.
name	String	Der Profilname.
description	String	Die Profilbeschreibung.
Benchmark	String	Der Profilbenchmark.
Version	String	Die Profilversion.
operatingSystem	String	Das profil anwendbare Betriebssystem.
operatingSystemVersion	String	Die für das Profil geltende Betriebssystemversion.
status	Boolesch	Gibt an, ob das Profil aktiv ist oder nicht.
complianceLevel	String	Die für das Profil ausgewählte Konformitätsstufe.
settingsNumber	Int	Anzahl der ausgewählten Konfigurationen im Profil.
createdBy	Zeichenfolge	Der Benutzer, der dieses Profil erstellt hat.
lastUpdatedBy	DateTime	Der letzte Benutzer, der dieses Profil geändert hat.
createdOnTimeOffset	DateTime	Das Datum und die Uhrzeit der Profilerstellung.
lastUpdateTimeOffset	DateTime	Das Datum und die Uhrzeit der letzten Aktualisierung des Profils.
passedGeräte	Int	Die Anzahl der Geräte, die für dieses Profil gelten und mit allen Profilkonfigurationen kompatibel sind.
totalDevices	Int	Anzahl der Geräte, die für dieses Profil gelten.

1.5 Beispiel

1.5.1 Anforderungsbeispiel

GET https://api.securitycenter.microsoft.com/api/baselineProfiles

1.6.2 Antwortbeispiel

{
    "@odata.context": "https:// api.securitycenter.microsoft.com/api/$metadata#Collection(microsoft.windowsDefenderATP.api.PublicBaselineProfileDto)",
    "value":
    [
        {
            "id": "02bcbb9d-d197-479e-811e-1cd5a6f9f8fa",
            "name": "Windows 10 build 1909 CIS profile",
            "description": "important",
            "benchmark": "CIS",
            "version": "1.0.0",
            "operatingSystem": "Windows 10",
            "operatingSystemVersion": "1909",
            "status": true,
            "complianceLevel": "Level 1 (L1) - Corporate/Enterprise Environment (general use)",
            "settingsNumber": 51,
            "createdBy": "user@org.net",
            "lastUpdatedBy": null,
            "createdOnTimestampUTC": "0001-01-01T00:00:00Z",
            "lastUpdateTimestampUTC": "0001-01-01T00:00:00Z",
            "passedDevices": 0,
            "totalDevices": 10
        }
     ]
}

Siehe auch

• Bewertung von Sicherheitsbaselines exportieren
• Abrufen von Bewertungskonfigurationen für Sicherheitsbaselines

Tipp

Möchten Sie mehr erfahren? Engage mit der Microsoft-Sicherheitscommunity in unserer Tech Community: Microsoft Defender for Endpoint Tech Community.