Erhalten von installierter Software

Wichtig

Einige Informationen in diesem Artikel beziehen sich auf ein vorab veröffentlichtes Produkt, das vor der kommerziellen Veröffentlichung möglicherweise erheblich geändert wird. Microsoft übernimmt in Bezug auf die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklich noch konkludent.

Ruft eine Sammlung installierter Software im Zusammenhang mit einer bestimmten Geräte-ID ab.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, einschließlich der Auswahl von Berechtigungen, finden Sie unter Verwenden von Microsoft Defender for Endpoint-APIs.

Berechtigungstyp Permission Anzeigename der Berechtigung
Application Software.Read.All Informationen zur Bedrohungs- und Sicherheitsrisikomanagementsoftware lesen
Delegiert (Geschäfts-, Schul- oder Unikonto) Software.Read Informationen zur Bedrohungs- und Sicherheitsrisikomanagementsoftware lesen

HTTP-Anforderung

GET /api/machines/{machineId}/software

Anforderungsheader

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

Anforderungstext

Empty

Antwort

Wenn die Methode erfolgreich verläuft, wird 200 OK mit den installierten Softwareinformationen im Text zurückgegeben.

Beispiel

Anforderungsbeispiel

Nachfolgend sehen Sie ein Beispiel der Anforderung.

GET https://api.security.microsoft.com/api/machines/ac233fa6208e1579620bf44207c4006ed7cc4501/software

Anforderungsbeispiel

Hier ist ein Beispiel für die Antwort.

{
"@odata.context": "https://api.security.microsoft.com/api/$metadata#Software",
"value": [
        {
"id": "microsoft-_-internet_explorer",
"name": "internet_explorer",
"vendor": "microsoft",
"weaknesses": 67,
"publicExploit": true,
"activeAlert": false,
"exposedMachines": 42115,
"impactScore": 46.2037163
        }
    ]
}