Jaa

Suorita virustentorjunnan tarkistuksen ohjelmointirajapinta

  • Artikkeli

Koskee seuraavia:

Haluatko kokea Microsoft Defender for Endpointin? Rekisteröidy maksuttomaan kokeiluversioon.

Huomautus

Jos olet Yhdysvaltain valtionhallinnon asiakas, käytä Microsoft Defender for Endpoint for Us Government -asiakkaille lueteltuja URI-osoitteita.

Vihje

Suorituskyvyn parantamiseksi voit käyttää palvelinta lähempänä maantieteellistä sijaintiasi:

  • us.api.security.microsoft.com
  • eu.api.security.microsoft.com
  • uk.api.security.microsoft.com
  • au.api.security.microsoft.com
  • swa.api.security.microsoft.com
  • ina.api.security.microsoft.com

Ohjelmointirajapinnan kuvaus

Käynnistä Microsoft Defenderin virustentorjuntatarkistus laitteessa.

Rajoitukset

  1. Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.

Huomautus

Tällä sivulla keskitytään konetoiminnon suorittamiseen ohjelmointirajapinnan kautta. Lisätietoja vastaustoimintojen toiminnoista päätepisteen Microsoft Defenderin kautta on artikkelissa Tietokoneen vastaustoimintojen lisääminen .

Tärkeää

  • Tämä toiminto on käytettävissä laitteille Windows 10:n versiossa 1709 tai uudemmissa versioissa ja Windows 11:ssä.
  • Microsoft Defenderin virustentorjuntatarkistus voidaan suorittaa yhdessä muiden virustentorjuntaratkaisujen kanssa riippumatta siitä, onko Microsoft Defenderin virustentorjunta aktiivinen virustentorjuntaratkaisu vai ei. Microsoft Defenderin virustentorjunta voi olla passiivitilassa. Lisätietoja on artikkelissa Microsoft Defenderin virustentorjunnan yhteensopivuus.

Käyttöoikeudet

Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Lisätietoja, mukaan lukien käyttöoikeuksien valitseminen, on artikkelissa Microsoft Defenderin käyttö päätepisteiden ohjelmointirajapinnoille

Käyttöoikeustyyppi Lupa Käyttöoikeuden näyttönimi
Sovellus Machine.Scan 'Tarkistuskone'
Delegoitu (työpaikan tai oppilaitoksen tili) Machine.Scan 'Tarkistuskone'

Huomautus

Kun hankit tunnuksen käyttäjän tunnistetiedoilla:

Laiteryhmän luontia tuetaan Defender for Endpoint -palvelupaketti 1:ssä ja palvelupakettissa 2.

HTTP-pyyntö

POST https://api.security.microsoft.com/api/machines/{id}/runAntiVirusScan

Pyynnön otsikot

Nimi Kirjoita Kuvaus
Lupa Merkkijono Haltija {token}. Pakollinen.
Sisältötyyppi merkkijono application/json

Pyynnön leipäteksti

Anna pyynnön leipätekstissä JSON-objekti, jolla on seuraavat parametrit:

Parametri Kirjoita Kuvaus
Kommentoi Merkkijono Toimintoon liitettävä kommentti. Pakollinen.
ScanType Merkkijono Määrittää tarkistuksen tyypin. Pakollinen.

ScanType määrittää suoritettavan tarkistuksen tyypin, ja se voi olla jokin seuraavista:

  • Pika: Pikatarkistus laitteessa
  • Täysi: Suorita täysi tarkistus laitteessa

Vastaus

Jos tämä menetelmä onnistuu, se palauttaa arvon 201, luotu vastauskoodin ja machineaction-objektin vastauksen leipätekstiin.

Jos lähetät useita ohjelmointirajapintakutsuja saman laitteen virustentorjuntatarkistuksen suorittamiseksi, se palauttaa "odottavan konetoiminnon" tai HTTP 400:n, jossa on viesti "Toiminto on jo käynnissä".

Esimerkki

Pyytää

Tässä on esimerkki pyynnöstä.

POST https://api.security.microsoft.com/api/machines/1e5bc9d7e413ddd7902c2932e418702b84d0cc07/runAntiVirusScan 

{
  "Comment": "Check machine for viruses due to alert 3212",
  "ScanType": "Full"
}

Vihje

Haluatko tietää lisää? Ole yhteydessä Microsoft Security -yhteisöön teknologiayhteisössämme: Microsoft Defender for Endpoint Tech -yhteisössä.