Muistiinpano
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää kirjautua sisään tai vaihtaa hakemistoa.
Tämän sivun käyttö edellyttää valtuutusta. Voit yrittää vaihtaa hakemistoa.
Ohjelmointirajapinnan kuvaus
Käynnistä virustentorjuntaohjelman Microsoft Defender laitteessa.
Microsoft Defender virustentorjuntatarkistus voidaan suorittaa yhdessä muiden virustentorjuntaratkaisujen kanssa riippumatta siitä, onko Microsoft Defender virustentorjunta aktiivinen virustentorjuntaratkaisu vai ei. Microsoft Defender virustentorjunta voi olla passiivitilassa. Lisätietoja on artikkelissa Microsoft Defender virustentorjuntaohjelman yhteensopivuus.
Rajoitukset
Tämän ohjelmointirajapinnan nopeusrajoitukset ovat 100 puhelua minuutissa ja 1 500 puhelua tunnissa.
Ennakkovaatimukset
Tuetut käyttöjärjestelmät
- Tämä toiminto on käytettävissä laitteissa, Windows 10 versiossa 1709 tai uudemmassa sekä Windows 11.
Käyttöoikeudet
Kun hankit tunnuksen käyttäjän tunnistetiedoilla:
- Käyttäjällä on oltava vähintään seuraava roolioikeus: Aktiiviset korjaustoiminnot. Lisätietoja on ohjeaiheessa Roolien luominen ja hallinta.
- Käyttäjällä on oltava laitteen käyttöoikeus laiteryhmän asetusten perusteella. Lisätietoja on kohdassa Laiteryhmien luominen ja hallinta.
Tämän ohjelmointirajapinnan kutsumiseen tarvitaan jokin seuraavista käyttöoikeuksista. Lisätietoja ja käyttöoikeuksien valitseminen on artikkelissa Microsoft Defender for Endpoint ohjelmointirajapintoja
| Käyttöoikeustyyppi | Lupa | Käyttöoikeuden näyttönimi |
|---|---|---|
| Sovellus | Machine.Scan | 'Tarkistuskone' |
| Delegoitu (työpaikan tai oppilaitoksen tili) | Machine.Scan | 'Tarkistuskone' |
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"
}