deviceCategory aktualisieren
Namespace: microsoft.graph
Wichtig: APIs unter der /beta-Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.
Hinweis: Die Microsoft Graph-API für Intune setzt eine aktive Intune-Lizenz für den Mandanten voraus.
Aktualisieren der Eigenschaften eines deviceCategory-Objekts
## Permissions
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 meisten Rechten zu der mit den wenigsten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | |
Geräteverwaltung | DeviceManagementManagedDevices.ReadWrite.All |
Onboarding | DeviceManagementManagedDevices.ReadWrite.All |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | |
Geräteverwaltung | DeviceManagementManagedDevices.ReadWrite.All |
Onboarding | DeviceManagementManagedDevices.ReadWrite.All |
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
HTTP-Anforderung
Geräteverwaltung
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceCategory
Onboarding
PATCH /deviceManagement/deviceCategories/{deviceCategoryId}
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 des Objekt des Typs deviceCategory an.
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie ein Objekt des Typs deviceCategory erstellen.
Eigenschaft | Typ | Beschreibung |
---|---|---|
id | String | Der eindeutige Bezeichner für die Gerätekategorie. Schreibgeschützt. |
Onboarding | ||
description | String | Optionale Beschreibung für die Gerätekategorie. |
displayName | String | Der Anzeigename für die Gerätekategorie. |
Antwort
Wenn die Methode erfolgreich verläuft, werden der Antwortcode 200 OK
und ein aktualisiertes deviceCategory-Objekt im Antworttext zurückgegeben.
Beispiel
Anforderung
Im Folgenden finden Sie Beispiele für die Anforderung.
PATCH https://graph.microsoft.com/beta/deviceManagement/deviceCategories/{deviceCategoryId}
Content-type: application/json
Content-length: 82
{
"displayName": "Display Name value",
"description": "Description value"
}
PATCH /deviceManagement/deviceManagementScripts/{deviceManagementScriptId}/deviceRunStates/{deviceManagementScriptDeviceStateId}/managedDevice/deviceCategory
Antwort
Nachfolgend sehen Sie ein Beispiel der Antwort. Hinweis: Das hier gezeigte Antwortobjekt ist möglicherweise aus Platzgründen abgeschnitten. Antworteigenschaften variieren je nach Kontext.
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 184
{
"@odata.type": "#microsoft.graph.deviceCategory",
"id": "f881b841-b841-f881-41b8-81f841b881f8",
"displayName": "Display Name value",
"description": "Description value"
}