Aktualisieren von „deviceComplianceUserOverview“
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.
Diese Methode aktualisiert die Eigenschaften von Objekten des Typs deviceComplianceUserOverview.
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 |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | DeviceManagementConfiguration.ReadWrite.All |
HTTP-Anforderung
PATCH /deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}/userStatusOverview
Anforderungsheader
Kopfzeile | Wert |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung. |
Annehmen | application/json |
Anforderungstext
Geben Sie als Anforderungstext eine JSON-Darstellung des Objekts des Typs deviceComplianceUserOverview an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs deviceComplianceUserOverview erstellen.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | String | Schlüssel der Entität |
pendingCount | Int32 | Anzahl der ausstehenden Benutzer |
notApplicableCount | Int32 | Anzahl der nicht anwendbaren Benutzer |
successCount | Int32 | Anzahl der erfolgreichen Benutzer |
errorCount | Int32 | Anzahl der Benutzer mit Fehlern |
failedCount | Int32 | Anzahl der fehlgeschlagenen Benutzer |
conflictCount | Int32 | Anzahl von Benutzern in Konflikt |
lastUpdateDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Aktualisierung |
configurationVersion | Int32 | Version der Richtlinie für diese Übersicht |
Antwort
Bei erfolgreicher Ausführung gibt die Methode den Antwortcode 200 OK
und ein aktualisiertes Objekt des Typs deviceComplianceUserOverview im Antworttext zurück.
Beispiel
Anforderung
Nachfolgend sehen Sie ein Beispiel der Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceCompliancePolicies/{deviceCompliancePolicyId}/userStatusOverview
Content-type: application/json
Content-length: 303
{
"@odata.type": "#microsoft.graph.deviceComplianceUserOverview",
"pendingCount": 12,
"notApplicableCount": 2,
"successCount": 12,
"errorCount": 10,
"failedCount": 11,
"conflictCount": 13,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
"configurationVersion": 4
}
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: 352
{
"@odata.type": "#microsoft.graph.deviceComplianceUserOverview",
"id": "2d4f5bf4-5bf4-2d4f-f45b-4f2df45b4f2d",
"pendingCount": 12,
"notApplicableCount": 2,
"successCount": 12,
"errorCount": 10,
"failedCount": 11,
"conflictCount": 13,
"lastUpdateDateTime": "2016-12-31T23:58:21.6459442-08:00",
"configurationVersion": 4
}