Freigeben über

DeviceManagementConfigurationCategory aktualisieren

Namespace: microsoft.graph

Wichtig: Microsoft unterstützt Intune/beta-APIs, die jedoch häufiger geändert werden. Microsoft empfiehlt, nach Möglichkeit Version 1.0 zu verwenden. Überprüfen Sie die Verfügbarkeit einer API in Version 1.0 mithilfe der Versionsauswahl.

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

Aktualisieren sie die Eigenschaften eines deviceManagementConfigurationCategory-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
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Application DeviceManagementConfiguration.ReadWrite.All

HTTP-Anforderung

PATCH /deviceManagement/inventoryCategories/{deviceManagementConfigurationCategoryId}
PATCH /deviceManagement/complianceCategories/{deviceManagementConfigurationCategoryId}
PATCH /deviceManagement/configurationCategories/{deviceManagementConfigurationCategoryId}

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 deviceManagementConfigurationCategory an .

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

Eigenschaft Typ Beschreibung
id Zeichenfolge Der eindeutige Bezeichner für die Kategorie.
description Zeichenfolge Beschreibung der Kategorie. Beispiel: Anzeigen
categoryDescription Zeichenfolge Beschreibung des Kategorieheaders in der Richtlinienzusammenfassung.
helpText Zeichenfolge Hilfetext der Kategorie. Geben Sie weitere Details zur Kategorie an.
name Zeichenfolge Name des Elements
displayName Zeichenfolge Name der Kategorie. Beispiel: Gerätesperre
Plattformen deviceManagementConfigurationPlatforms Plattformtypen, über die Einstellungen in der Kategorie verfügen. Die möglichen Werte sind: none. android, androidEnterprise, iOs, macOs, windows10X, windows10, aosp und linux. Wenn diese Eigenschaft nicht oder auf keine festgelegt ist, gibt Kategorien auf allen Plattformen zurück. Unterstützt: $filters, $select. Schreibgeschützt. Die möglichen Werte sind: none, android, iOS, macOS, windows10X, , linuxwindows10, unknownFutureValue, androidEnterprise, aosp, visionOS, . tvOS
technologieen deviceManagementConfigurationTechnologies Technologietypen, über die Einstellungen in der Kategorie verfügen. Mögliche Werte sind: none, mdm, configManager, intuneManagementExtension, thirdParty, documentGateway, appleRemoteManagement, microsoftSense, exchangeOnline, edgeMam, linuxMdm, extensibility, enrollment, endpointPrivilegeManagement. Wenn diese Eigenschaft nicht oder auf keine festgelegt ist, gibt Kategorien auf allen Plattformen zurück. Unterstützt: $filters, $select. Schreibgeschützt. Die möglichen Werte sind: none, mdm, windows10XManagement, configManager, appleRemoteManagement, , microsoftSense, mobileApplicationManagementexchangeOnline, linuxMdm, extensibilityenrollmentunknownFutureValueendpointPrivilegeManagement, , . androidwindowsOsRecovery
settingUsage deviceManagementConfigurationSettingUsage Gibt an, dass die Kategorie Einstellungen enthält, die für Kompatibilitäts-, Konfigurations- oder wiederverwendbare Einstellungen verwendet werden. Die möglichen Werte sind: Konfiguration, Compliance, reusableSetting. Für jede Einstellungsverwendung muss ein separater API-Endpunkt aufgerufen werden. Schreibgeschützt. Mögliche Werte sind: none, configuration, compliance, unknownFutureValue, inventory.
parentCategoryId Zeichenfolge Direkte übergeordnete ID der Kategorie. Wenn die Kategorie der Stamm ist, ist die übergeordnete ID mit ihrer ID identisch.
rootCategoryId Zeichenfolge Stamm-ID der Kategorie.
childCategoryIds String collection Liste der untergeordneten IDs der Kategorie.

Antwort

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

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

PATCH https://graph.microsoft.com/beta/deviceManagement/inventoryCategories/{deviceManagementConfigurationCategoryId}
Content-type: application/json
Content-length: 523

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationCategory",
  "description": "Description value",
  "categoryDescription": "Category Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "platforms": "android",
  "technologies": "mdm",
  "settingUsage": "configuration",
  "parentCategoryId": "Parent Category Id value",
  "rootCategoryId": "Root Category Id value",
  "childCategoryIds": [
    "Child Category Ids value"
  ]
}

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: 572

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationCategory",
  "id": "cff34dd2-4dd2-cff3-d24d-f3cfd24df3cf",
  "description": "Description value",
  "categoryDescription": "Category Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "platforms": "android",
  "technologies": "mdm",
  "settingUsage": "configuration",
  "parentCategoryId": "Parent Category Id value",
  "rootCategoryId": "Root Category Id value",
  "childCategoryIds": [
    "Child Category Ids value"
  ]
}
  • Last updated on