Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
| Weltweiter Service | 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 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"
}