Eksporter programvarebeholdningsvurdering per enhet
Gjelder for:
- Microsoft Defender for endepunkt plan 1
- Microsoft Defender for endepunkt plan 2
- Håndtering av trusler og sikkerhetsproblemer i Microsoft Defender
- Microsoft Defender XDR
Vil du oppleve Microsoft Defender for endepunkt? Registrer deg for en gratis prøveperiode.
Denne API-en returnerer alle dataene for installert programvare som har en Common Platform Enumeration(CPE) per enhet.
Ulike API-kall får ulike typer data. Fordi datamengden kan være stor, finnes det to måter den kan hentes på:
Eksporter JSON-svar for programvarebeholdningsvurdering API-en henter alle data i organisasjonen som Json-svar. Denne metoden er best for små organisasjoner med mindre enn 100 K-enheter. Svaret er paginert, slik at du kan bruke @odata.nextLink-feltet fra svaret til å hente de neste resultatene.
Eksporter vurdering av programvarebeholdning via filer Denne API-løsningen gjør det mulig å hente større datamengder raskere og mer pålitelig. Det anbefales derfor for store organisasjoner, med mer enn 100 K-enheter. Denne API-en henter alle data i organisasjonen som nedlastingsfiler. Svaret inneholder nettadresser for å laste ned alle dataene fra Azure Storage. Med denne API-en kan du laste ned alle dataene dine fra Azure Storage på følgende måte:
- Kall API-en for å få en liste over nedlasting av nettadresser med alle organisasjonsdataene.
- Last ned alle filene ved hjelp av url-adressene for nedlasting, og behandle dataene slik du vil.
Data som samles inn (ved hjelp av Json-svar eller via filer) er det gjeldende øyeblikksbildet av gjeldende tilstand. Den inneholder ikke historiske data. For å samle inn historiske data må kundene lagre dataene i sine egne datalagringer.
Obs!
Med mindre annet er angitt, er alle eksportvurderingsmetodene fullstendig eksport og etter enhet (også referert til som per enhet).
1. Eksporter programvarebeholdningsvurdering (JSON-svar)
Beskrivelse av API-metode 1.1
Dette API-svaret inneholder alle data fra installert programvare som har en Common Platform Enumeration(CPE), per enhet. Returnerer en tabell med en oppføring for hver unike kombinasjon av DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion.
1.1.1 Begrensninger
- Maksimal sidestørrelse er 200 000.
- Satsbegrensninger for denne API-en er 30 oppkall per minutt og 1000 anrop per time.
1.2 Tillatelser
Én av følgende tillatelser er nødvendig for å kalle opp denne API-en. Hvis du vil ha mer informasjon, inkludert hvordan du velger tillatelser, kan du se Bruke Microsoft Defender for endepunkt API-er for mer informasjon.
| Tillatelsestype | Tillatelse | Visningsnavn for tillatelse |
|---|---|---|
| Program | Software.Read.All | Les informasjon om programvare for trussel- og sårbarhetsbehandling |
| Delegert (jobb- eller skolekonto) | Software.Read | Les informasjon om programvare for trussel- og sårbarhetsbehandling |
1.3 URL-adresse
GET /api/machines/SoftwareInventoryByMachine
1.4 Parametere
- pageSize (standard = 50 000): Antall resultater som svar.
- $top: Antall resultater som skal returneres (returnerer @odata.nextLink ikke, og henter derfor ikke alle dataene)
1.5 Egenskaper
Obs!
- Hver post er omtrent 0,5 KB med data. Du bør ta hensyn til dette når du velger riktig pageSize-parameter for deg.
- Egenskapene som er definert i tabellen nedenfor, er oppført alfabetisk, etter egenskaps-ID. Når du kjører denne API-en, returneres ikke nødvendigvis resultatet i den samme rekkefølgen som er oppført i denne tabellen.
- Noen ekstra kolonner kan returneres i svaret. Disse kolonnene er midlertidige og kan bli fjernet. Bruk bare de dokumenterte kolonnene.
| Egenskap (ID) | Datatype | Beskrivelse | Eksempel på en returnert verdi |
|---|---|---|---|
| Deviceid | Streng | Unik identifikator for enheten i tjenesten. | 9eaf3a8b5962e0e6b1af9ec756664a9b823df2d1 |
| DeviceName | Streng | Fullstendig domenenavn (FQDN) for enheten. | johnlaptop.europe.contoso.com |
| DiskPaths | Matrise[streng] | Diskbevis for at produktet er installert på enheten. | ["C:\Programfiler (x86)\Microsoft\Silverlight\Application\silverlight.exe"] |
| EndOfSupportDate | Streng | Datoen da støtte for denne programvaren har eller slutter. | 2020-12-30 |
| EndOfSupportStatus | Streng | Status for slutt på støtte. Kan inneholde disse mulige verdiene: Ingen, EOS-versjon, kommende EOS-versjon, EOS-programvare, kommende EOS-programvare. | Kommende EOS |
| NumberOfWeaknesses | Int | Antall svakheter på denne programvaren på denne enheten | 3 |
| OSPlatform | Streng | Plattformen for operativsystemet som kjører på enheten. Dette er bestemte operativsystemer med variasjoner i samme familie, for eksempel Windows 10 og Windows 11. Se Microsoft Defender Vulnerability Management operativsystemer og plattformer som støttes, for mer informasjon. | Windows10 og Windows 11 |
| RbacGroupName | Streng | Rollebasert tilgangskontrollgruppe (RBAC). Hvis denne enheten ikke er tilordnet til en RBAC-gruppe, blir verdien ikke tilordnet. Hvis organisasjonen ikke inneholder rbac-grupper, blir verdien «Ingen». | Servere |
| RegistryPaths | Matrise[streng] | Registrer bevis på at produktet er installert på enheten. | ["HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\Microsoft Silverlight"] |
| SoftwareFirstSeenTimestamp | Streng | Første gang denne programvaren ble sett på enheten. | 2019-04-07 02:06:47 |
| SoftwareName | Streng | Navnet på programvareproduktet. | Silverlight |
| SoftwareVendor | Streng | Navnet på programvareleverandøren. | Microsoft |
| SoftwareVersion | Streng | Versjonsnummeret til programvareproduktet. | 81.0.4044.138 |
1.6 Eksempler
1.6.1 Eksempel på forespørsel
GET https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryByMachine?pageSize=5 &sinceTime=2021-05-19T18%3A35%3A49.924Z
1.6.2 Svareksempel
{
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#Collection(contoso.windowsDefenderATP.api.AssetSoftware)",
"value": [
{
"deviceId": "00044f68765bbaf712342dbe6db733b6a9c59ab4",
"rbacGroupName": "hhh",
"deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eeb80d086e79dbfa178eadfa25e8de9acfa346.corp.contoso.com",
"osPlatform": "Windows10" "Windows11",
"softwareVendor": "microsoft",
"softwareName": "windows_10" "Windows_11",
"softwareVersion": "10.0.17763.1637",
"numberOfWeaknesses": 58,
"diskPaths": [],
"registryPaths": [],
"softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
"endOfSupportStatus": "Upcoming EOS Version",
"endOfSupportDate": "2021-05-11T00:00:00+00:00"
},
{
"deviceId": "00044f68765bbaf712342dbe6db733b6a9c59ab4",
"rbacGroupName": "hhh",
"deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eeb80d086e79dbfa178eadfa25e8de9acfa346.corp.contoso.com",
"osPlatform": "Windows10" "Windows11",
"softwareVendor": "microsoft",
"softwareName": ".net_framework",
"softwareVersion": "4.0.0.0",
"numberOfWeaknesses": 0,
"diskPaths": [],
"registryPaths": [
"SOFTWARE\\Microsoft\\NET Framework Setup\\NDP\\v4.0\\Client\\Install"
],
"softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
"endOfSupportStatus": "None",
"endOfSupportDate": null
},
{
"deviceId": "00044f68765bbaf712342dbe6db733b6a9c59ab4",
"rbacGroupName": "hhh",
"deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eed80d086e79bdfa178eadfa25e8de9acfa346.corp.contoso.com",
"osPlatform": "Windows10" "Windows11",
"softwareVendor": "microsoft",
"softwareName": "system_center_2012_endpoint_protection",
"softwareVersion": "4.7.214.0",
"numberOfWeaknesses": 0,
"diskPaths": [],
"registryPaths": [
"HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Microsoft Security Client"
],
"softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
"endOfSupportStatus": "None",
"endOfSupportDate": null
},
{
"deviceId": "00044f68765ddaf71234bde6bd733d6a9c59ad4",
"rbacGroupName": "hhh",
"deviceName": "ComputerPII_18993b45912eeb224b2be2f5ea3142726e63f16a.DomainPII_21eeb80d086e79dbfa178aedfa25e8be9acfa346.corp.contoso.com",
"osPlatform": "Windows10" "Windows11",
"softwareVendor": "microsoft",
"softwareName": "configuration_manager",
"softwareVersion": "5.0.8634.1000",
"numberOfWeaknesses": 0,
"diskPaths": [],
"registryPaths": [
"HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\{B7D3A842-E826-4542-B39B-1D883264B279}"
],
"softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
"endOfSupportStatus": "None",
"endOfSupportDate": null
},
{
"deviceId": "00044f38765bbaf712342dbe6db733b6a9c59ab4",
"rbacGroupName": "hhh",
"deviceName": "ComputerPII_18993b45912eeb224b2de2f5ea3142726e63f16a.DomainPII_21eeb80d086e79bdfa178eadfa25e8be9acfa346.corp.contoso.com",
"osPlatform": "Windows10" "Windows11",
"softwareVendor": "microsoft",
"softwareName": "system_center_2012_endpoint_protection",
"softwareVersion": "4.10.209.0",
"numberOfWeaknesses": 0,
"diskPaths": [],
"registryPaths": [
"HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\Microsoft Security Client"
],
"softwareFirstSeenTimestamp": "2020-12-30 11:07:15",
"endOfSupportStatus": "None",
"endOfSupportDate": null
}
],
"@odata.nextLink": "https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryByMachine?pagesize=5&$skiptoken=eyJFeHBvcnREZWZpbml0aW9uIjp7IlRpbWVQYXRoIjoiMjAyMS0wMS0yNS8wMjAwLyJ9LCJFeHBvcnRGaWxlSW5kZXgiOjAsIkxpbmVTdG9wcGVkQXQiOjV9"
}
Obs!
Informasjonen som returneres av denne API-en, sammen med informasjonen som returneres av API-en for eksport av ikke-produktkodeprogramvare , for programvare som ikke har en CPE, gir deg full innsyn i programvaren som er installert på tvers av organisasjonen og enhetene den er installert på.
2. Eksporter programvarebeholdningsvurdering (via filer)
Beskrivelse av API-metode 2.1
Dette API-svaret inneholder alle data fra installert programvare per enhet. Returnerer en tabell med en oppføring for hver unike kombinasjon av DeviceId, SoftwareVendor, SoftwareName, SoftwareVersion.
2.1.1 Begrensninger
Satsbegrensninger for denne API-en er fem kall per minutt og 20 oppkall per time.
2.2 Tillatelser
Én av følgende tillatelser er nødvendig for å kalle opp denne API-en. Hvis du vil ha mer informasjon, inkludert hvordan du velger tillatelser, kan du se Bruke Microsoft Defender for endepunkt API-er for mer informasjon.
| Tillatelsestype | Tillatelse | Visningsnavn for tillatelse |
|---|---|---|
| Program | Software.Read.All | Les informasjon om programvare for trussel- og sårbarhetsbehandling |
| Delegert (jobb- eller skolekonto) | Software.Read | Les informasjon om programvare for trussel- og sårbarhetsbehandling |
2.3 URL-adresse
GET /api/machines/SoftwareInventoryExport
Parametere
- sasValidHours: Antall timer nedlastings-URL-adressene skal være gyldige for (maksimalt 24 timer)
2.5 Egenskaper
Obs!
- Filene er gzip komprimert & i flerlinjet JSON-format.
- URL-adressene for nedlasting er bare gyldige i tre timer. Ellers kan du bruke parameteren.
- Du kan kontrollere at du laster ned fra samme Azure-område som dataene befinner seg, for maksimal nedlastingshastighet for dataene dine.
| Egenskap (ID) | Datatype | Beskrivelse | Eksempel på en returnert verdi |
|---|---|---|---|
| Eksportere filer | matrise[streng] | En liste over nedlasting av nettadresser for filer som holder det gjeldende øyeblikksbildet av organisasjonen | "[Https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...1", "https://tvmexportstrstgeus.blob.core.windows.net/tvm-export...2"] |
| GeneratedTime | Streng | Tidspunktet da eksporten ble generert. | 2021-05-20T08:00:00Z |
2.6 Eksempler
2.6.1 Eksempel på forespørsel
GET https://api.securitycenter.microsoft.com/api/machines/SoftwareInventoryExport
2.6.2 Svareksempel
{
"@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#microsoft.windowsDefenderATP.api.ExportFilesResponse",
"exportFiles": [
"https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/SoftwareInventory/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00393-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
"https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/SoftwareInventory/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c000.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=...",
"https://tvmexportstrstgeus.blob.core.windows.net/tvm-export/2021-01-11/1101/SoftwareInventory/json/OrgId=12345678-195f-4223-9c7a-99fb420fd000/part-00394-e423630d-4c69-4490-8769-a4f5468c4f25.c001.json.gz?sv=2019-12-12&st=2021-01-11T11%3A55%3A51Z&se=2021-01-11T14%3A55%3A51Z&sr=b&sp=r&sig=..."
],
"generatedTime": "2021-01-11T11:01:00Z"
}
Se også
- Eksportere vurderingsmetoder og egenskaper per enhet
- Eksporter vurdering av sikker konfigurasjon per enhet
- Eksporter vurdering av programvaresårbarheter per enhet
- Eksporter beholdningsvurdering for programvare for ikke-produktkode
Andre relaterte
Tips
Vil du lære mer? Engage med Microsoft Security-fellesskapet i teknisk fellesskap: Microsoft Defender for endepunkt teknisk fellesskap.
Tilbakemeldinger
Kommer snart: Gjennom 2024 faser vi ut GitHub Issues som tilbakemeldingsmekanisme for innhold, og erstatter det med et nytt system for tilbakemeldinger. Hvis du vil ha mer informasjon, kan du se: https://aka.ms/ContentUserFeedback.
Send inn og vis tilbakemelding for