Share via


Auflisten aller Bewertungsprofile für Sicherheitsbaselines

Gilt für:

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

Tipp

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