Freigeben über

Aktualisieren von windowsProtectionState

  • Artikel

Namespace: microsoft.graph

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

Aktualisieren sie die Eigenschaften eines windowsProtectionState-Objekts .

Berechtigungen

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

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

HTTP-Anforderung

PATCH /deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/windowsProtectionState

Anforderungsheader

Kopfzeile Wert
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.
Annehmen application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung für das windowsProtectionState-Objekt an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von windowsProtectionState erforderlich sind.

Eigenschaft Typ Beschreibung
id String Der eindeutige Bezeichner für den Geräteschutz status -Objekt. Dies ist die Geräte-ID des Geräts.
malwareProtectionEnabled Boolesch Wenn TRUE angibt, dass Antischadsoftware aktiviert ist, wenn FALSE angibt, dass Antischadsoftware nicht aktiviert ist.
deviceState windowsDeviceHealthState Gibt den Integritätsstatus des Geräts an. Mögliche Werte sind: sauber, fullScanPending, rebootPending, manualStepsPending, offlineScanPending, critical. Mögliche Werte sind: clean, fullScanPending, rebootPending, manualStepsPending, offlineScanPending und critical.
realTimeProtectionEnabled Boolesch Wenn TRUE angibt, dass der Echtzeitschutz aktiviert ist, wenn FALSE angibt, dass der Echtzeitschutz nicht aktiviert ist. Standardmäßig wird die Einstellung auf dem Clientgerät festgelegt.
networkInspectionSystemEnabled Boolesch Wenn TRUE angibt, dass das Netzwerkinspektionssystem aktiviert ist, wenn FALSE angibt, dass das Netzwerküberprüfungssystem nicht aktiviert ist. Standardmäßig wird die Einstellung auf dem Clientgerät festgelegt.
quickScanOverdue Boolesch Wenn TRUE angibt, dass die Schnellüberprüfung überfällig ist, wenn FALSE angibt, dass die Schnellüberprüfung nicht überfällig ist. Standardmäßig wird die Einstellung auf dem Clientgerät festgelegt.
fullScanOverdue Boolesch Wenn TRUE angibt, dass die vollständige Überprüfung überfällig ist, wenn FALSE angibt, dass die vollständige Überprüfung nicht überfällig ist. Standardmäßig wird die Einstellung auf dem Clientgerät festgelegt.
signatureUpdateOverdue Boolesch Wenn TRUE angibt, dass die Signatur veraltet ist, wenn FALSE angibt, dass die Signatur nicht veraltet ist. Standardmäßig wird die Einstellung auf dem Clientgerät festgelegt.
rebootRequired Boolesch Wenn TRUE angibt, dass ein Neustart erforderlich ist, wenn FALSE angibt, wenn TRUE angibt, dass ein Neustart nicht erforderlich ist. Standardmäßig wird die Einstellung auf dem Clientgerät festgelegt.
fullScanRequired Boolesch Wenn TRUE angibt, dass eine vollständige Überprüfung erforderlich ist, wenn FALSE angibt, dass keine vollständige Überprüfung erforderlich ist. Standardmäßig wird die Einstellung auf dem Clientgerät festgelegt.
engineVersion String Aktuelle Endpoint Protection-Engine-Version
signatureVersion String Aktuelle Version von Schadsoftwaredefinitionen
antimalwareVersion String Aktuelle Antischadsoftwareversion
lastQuickScanDateTime DateTimeOffset Letzte Schnellüberprüfung datetime
lastFullScanDateTime DateTimeOffset Letzte Schnellüberprüfung datetime
lastQuickScanSignatureVersion String Letzte Schnellüberprüfung der Signaturversion
lastFullScanSignatureVersion String Letzte Signaturversion des vollständigen Scans
lastReportedDateTime DateTimeOffset Zeitpunkt der letzten gemeldeten Geräteintegrität status
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. Mögliche Werte sind: noStatus, serviceNotRunning, serviceStartedWithoutMalwareProtection, pendingFullScanDueToThreatAction, pendingRebootDueToThreatAction, pendingManualStepsDueToThreatAction, avSignaturesOutOfDatesystemInitiatedScanInProgressproductRunningInNonGenuineModeproductRunningInEvaluationModesamplesPendingSubmissionproductExpirednoFullScanHappenedForSpecifiedPeriodofflineScanRequiredserviceShutdownAsPartOfSystemShutdownsystemInitiatedCleanInProgressasSignaturesOutOfDatethreatRemediationFailedCriticallynoQuickScanHappenedForSpecifiedPeriod, , . windowsSModeSignaturesInUseOnNonWin10SInstallthreatRemediationFailedNonCriticallynoStatusFlagsSetplatformOutOfDateplatformUpdateInProgressplatformAboutToBeOutdatedsignatureOrPlatformEndOfLifeIsPastOrIsImpending
isVirtualMachine Boolesch Wenn TRUE angibt, dass das Gerät ein virtueller Computer ist, wenn FALSE angibt, dass das Gerät kein virtueller Computer ist. Standardmäßig wird die Einstellung auf dem Clientgerät festgelegt.
tamperProtectionEnabled Boolesch Wenn TRUE angibt, dass das Windows Defender Manipulationsschutz aktiviert ist, wenn FALSE angibt, dass das Windows Defender Manipulationsschutzfeature nicht aktiviert ist. Standardmäßig wird die Einstellung auf dem Clientgerät festgelegt.

Antwort

Wenn die Methode erfolgreich verläuft, werden der 200 OK Antwortcode und ein aktualisiertes windowsProtectionState-Objekt im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/v1.0/deviceManagement/detectedApps/{detectedAppId}/managedDevices/{managedDeviceId}/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
}