Visa en lista över alla utvärderingsprofiler för säkerhetsbaslinjer

Artikel
04/26/2024

Gäller för:

Vill du uppleva Microsoft Defender – hantering av säkerhetsrisker? Läs mer om hur du kan registrera dig för Microsoft Defender – hantering av säkerhetsrisker utvärderingsversion av den offentliga förhandsversionen.

1. Hämta utvärderingsprofiler för säkerhetsbaslinjer

Det här API:et hämtar en lista över alla utvärderingsprofiler för säkerhetsbaslinjer som skapats av organisationen.

1.1 Parametrar

Stöder OData V4-frågor.
Operatorer som stöds av OData:
- $filter på : id,name, operatingSystem, operatingSystemVersion, status, settingsNumber, passedDevices, totalDevices
- $top med ett maxvärde på 10 000.
- $skip.

1.2 HTTP-begäran

GET:/api/baselineProfiles

1.3 Begärandehuvuden

Namn	Typ	Beskrivning
Tillstånd	Sträng	Ägaren {token}. Krävs.

1.4 Egenskaper

Egenskap	Typ	Beskrivning
Id	Sträng	Unik identifierare för den specifika baslinjeprofilen.
Namn	Sträng	Profilnamnet.
beskrivning	Sträng	Profilbeskrivningen.
Riktmärke	Sträng	Profilens riktmärke.
Version	Sträng	Profilversionen.
operatingSystem	Sträng	Profilen som gäller operativsystem.
operatingSystemVersion	Sträng	Profilens tillämpliga operativsystemversion.
Status	Boolesk	Anger om profilen är aktiv eller inte
complianceLevel	Sträng	Den efterlevnadsnivå som valts för profilen.
settingsNumber	Int	Antal valda konfigurationer i profilen.
createdBy	Sträng	Användaren som skapade den här profilen.
lastUpdatedBy	Datetime	Den sista användaren som ändrade den här profilen.
createdOnTimeOffset	Datetime	Datum och tid då profilen skapades.
lastUpdateTimeOffset	Datetime	Datum och tid då profilen senast uppdaterades.
passedDevices	Int	Antalet enheter som gäller för den här profilen och som är kompatibla med alla profilkonfigurationer.
totalEnheter	Int	Antal enheter som gäller för den här profilen.

1.5 Exempel

1.5.1 Exempel på begäran

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

1.6.2 Svarsexempel

{
    "@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
        }
     ]
}

Se även

Tips

Vill du veta mer? Engage med Microsofts säkerhetscommunity i vår Tech Community: Microsoft Defender för Endpoint Tech Community.

Dela via