deviceComplianceScriptRunSummary aktualisieren
Namespace: microsoft.graph
Wichtig: Microsoft Graph-APIs unter der /beta-Version können sich ändern. Die Verwendung in der Produktion wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Aktualisieren sie die Eigenschaften eines deviceComplianceScriptRunSummary-Objekts .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Weltweiter Service | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
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) | 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/deviceComplianceScripts/{deviceComplianceScriptId}/runSummary
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie im Anforderungstext eine JSON-Darstellung für das Objekt deviceComplianceScriptRunSummary an .
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die beim Erstellen von deviceComplianceScriptRunSummary erforderlich sind.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | String | Schlüssel der Zusammenfassungsentität des Gerätekonformitätsskripts. Diese Eigenschaft ist schreibgeschützt. |
noIssueDetectedDeviceCount | Int32 | Anzahl der Geräte, für die das Erkennungsskript kein Problem gefunden hat und das Gerät fehlerfrei ist. Gültige Werte 2147483648 2147483647 |
issueDetectedDeviceCount | Int32 | Anzahl der Geräte, für die das Erkennungsskript ein Problem gefunden hat. Gültige Werte 2147483648 2147483647 |
detectionScriptErrorDeviceCount | Int32 | Anzahl der Geräte, auf denen bei der Ausführung des Erkennungsskripts ein Fehler aufgetreten ist und nicht abgeschlossen wurde. Gültige Werte 2147483648 2147483647 |
detectionScriptPendingDeviceCount | Int32 | Anzahl der Geräte, auf denen noch nicht die neueste Version des Gerätekonformitätsskripts ausgeführt wurde. Gültige Werte 2147483648 2147483647 |
lastScriptRunDateTime | DateTimeOffset | Letzte Ausführungszeit für das Skript auf allen Geräten |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den 200 OK
Antwortcode und ein aktualisiertes objekt deviceComplianceScriptRunSummary im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceComplianceScripts/{deviceComplianceScriptId}/runSummary
Content-type: application/json
Content-length: 295
{
"@odata.type": "#microsoft.graph.deviceComplianceScriptRunSummary",
"noIssueDetectedDeviceCount": 10,
"issueDetectedDeviceCount": 8,
"detectionScriptErrorDeviceCount": 15,
"detectionScriptPendingDeviceCount": 1,
"lastScriptRunDateTime": "2017-01-01T00:01:17.4310553-08:00"
}
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: 344
{
"@odata.type": "#microsoft.graph.deviceComplianceScriptRunSummary",
"id": "dad42f14-2f14-dad4-142f-d4da142fd4da",
"noIssueDetectedDeviceCount": 10,
"issueDetectedDeviceCount": 8,
"detectionScriptErrorDeviceCount": 15,
"detectionScriptPendingDeviceCount": 1,
"lastScriptRunDateTime": "2017-01-01T00:01:17.4310553-08:00"
}