windowsProtectionState aktualisieren

Namespace: microsoft.graph

Wichtig: Microsoft Graph APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung wird nicht unterstützt.

Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.

Dient zum Aktualisieren der Eigenschaften eines windowsProtectionState-Objekts.

Voraussetzungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	DeviceManagementConfiguration.ReadWrite.All, DeviceManagementManagedDevices.ReadWrite.All

HTTP-Anforderung

PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/windowsProtectionState

Anforderungsheader

Kopfzeile	Wert
Authorization	Bearer<token> erforderlich
Annehmen	application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Objekts des Typs "windowsProtectionState" an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs "windowsProtectionState"erstellen.

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Der eindeutige Bezeichner für das Geräteschutzstatusobjekt. Dies ist die Geräte-ID des Geräts.
malwareProtectionEnabled	Boolesch	Antischadsoftware ist aktiviert oder nicht
deviceState	windowsDeviceHealthState	Zustand des Computers (z. B. sauber oder ausstehender vollständiger Scan oder ausstehender Neustart usw.). Mögliche Werte sind: clean, fullScanPending, rebootPending, manualStepsPending, offlineScanPending und critical.
realTimeProtectionEnabled	Boolescher Wert	Echtzeitschutz ist aktiviert oder nicht?
networkInspectionSystemEnabled	Boolescher Wert	Netzwerküberprüfungssystem aktiviert oder nicht?
quickScanOverdue	Boolescher Wert	Schnellscan überfällig oder nicht?
fullScanOverdue	Boolescher Wert	Vollständiger Scan überfällig oder nicht?
signatureUpdateOverdue	Boolescher Wert	Signatur veraltet oder nicht?
rebootRequired	Boolesch	Neustart erforderlich oder nicht?
fullScanRequired	Boolesch	Vollständiger Scan erforderlich oder nicht?
engineVersion	Zeichenfolge	Aktuelle Version des Endpunktschutzmoduls
signatureVersion	Zeichenfolge	Aktuelle Version von Schadsoftwaredefinitionen
anmalwareVersion	Zeichenfolge	Aktuelle Antischadsoftwareversion
lastQuickScanDateTime	DateTimeOffset	Datum und Uhrzeit des letzten Schnellscans
lastFullScanDateTime	DateTimeOffset	Datum und Uhrzeit des letzten Schnellscans
lastQuickScanSignatureVersion	String	Letzte Signaturversion des Schnellscans
lastFullScanSignatureVersion	String	Letzte Signaturversion des vollständigen Scans
lastReportedDateTime	DateTimeOffset	Zeitpunkt des letzten gemeldeten Geräteintegritätsstatus
productStatus	windowsDefenderProductStatus	Produktstatus von Windows Defender Antivirus. Mögliche Werte sind: noStatus , , , , , , , , serviceNotRunning , , , serviceStartedWithoutMalwareProtection , , pendingFullScanDueToThreatAction , , , , pendingRebootDueToThreatAction , , , pendingManualStepsDueToThreatAction , , avSignaturesOutOfDate , , , asSignaturesOutOfDate noQuickScanHappenedForSpecifiedPeriod noFullScanHappenedForSpecifiedPeriod systemInitiatedScanInProgress systemInitiatedCleanInProgress samplesPendingSubmission productRunningInEvaluationMode productRunningInNonGenuineMode , productExpired offlineScanRequired serviceShutdownAsPartOfSystemShutdown threatRemediationFailedCritically threatRemediationFailedNonCritically noStatusFlagsSet platformOutOfDate platformUpdateInProgress platformAboutToBeOutdated . signatureOrPlatformEndOfLifeIsPastOrIsImpending windowsSModeSignaturesInUseOnNonWin10SInstall
isVirtualMachine	Boolescher Wert	Gibt an, ob das Gerät ein virtueller Computer ist.
tamperProtectionEnabled	Boolesch	Gibt an, ob die Windows Defender Manipulationsschutzfunktion aktiviert ist.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 200 OK Antwortcode und ein aktualisiertes WindowsProtectionState-Objekt im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/windowsProtectionState
Content-type: application/json
Content-length: 971

{
  "@odata.type": "#microsoft.graph.windowsProtectionState",
  "malwareProtectionEnabled": true,
  "deviceState": "fullScanPending",
  "realTimeProtectionEnabled": true,
  "networkInspectionSystemEnabled": true,
  "quickScanOverdue": true,
  "fullScanOverdue": true,
  "signatureUpdateOverdue": true,
  "rebootRequired": true,
  "fullScanRequired": true,
  "engineVersion": "Engine Version value",
  "signatureVersion": "Signature Version value",
  "antiMalwareVersion": "Anti Malware Version value",
  "lastQuickScanDateTime": "2016-12-31T23:58:27.5900669-08:00",
  "lastFullScanDateTime": "2017-01-01T00:01:44.9405639-08:00",
  "lastQuickScanSignatureVersion": "Last Quick Scan Signature Version value",
  "lastFullScanSignatureVersion": "Last Full Scan Signature Version value",
  "lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00",
  "productStatus": "serviceNotRunning",
  "isVirtualMachine": true,
  "tamperProtectionEnabled": true
}

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Von einem tatsächlichen Aufruf werden alle Eigenschaften zurückgegeben.

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1020

{
  "@odata.type": "#microsoft.graph.windowsProtectionState",
  "id": "1ac6ea5a-ea5a-1ac6-5aea-c61a5aeac61a",
  "malwareProtectionEnabled": true,
  "deviceState": "fullScanPending",
  "realTimeProtectionEnabled": true,
  "networkInspectionSystemEnabled": true,
  "quickScanOverdue": true,
  "fullScanOverdue": true,
  "signatureUpdateOverdue": true,
  "rebootRequired": true,
  "fullScanRequired": true,
  "engineVersion": "Engine Version value",
  "signatureVersion": "Signature Version value",
  "antiMalwareVersion": "Anti Malware Version value",
  "lastQuickScanDateTime": "2016-12-31T23:58:27.5900669-08:00",
  "lastFullScanDateTime": "2017-01-01T00:01:44.9405639-08:00",
  "lastQuickScanSignatureVersion": "Last Quick Scan Signature Version value",
  "lastFullScanSignatureVersion": "Last Full Scan Signature Version value",
  "lastReportedDateTime": "2017-01-01T00:00:17.7769392-08:00",
  "productStatus": "serviceNotRunning",
  "isVirtualMachine": true,
  "tamperProtectionEnabled": true
}