Erstellen von deviceManagementConfigurationCategory

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.

Erstellen Sie ein neues deviceManagementConfigurationCategory-Objekt .

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst	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

POST /deviceManagement/inventoryCategories
POST /deviceManagement/complianceCategories
POST /deviceManagement/configurationCategories

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 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. Mögliche 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. Mögliche Werte: none, android, iOS, macOS, windows10X, windows10, linux, unknownFutureValue.
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. Mögliche Werte sind: none, mdm, windows10XManagement, configManager, appleRemoteManagement, microsoftSense, , mobileApplicationManagementexchangeOnline, linuxMdm, extensibilityenrollment, , endpointPrivilegeManagement, unknownFutureValue, . windowsOsRecovery
settingUsage	deviceManagementConfigurationSettingUsage	Gibt an, dass die Kategorie Einstellungen enthält, die für Kompatibilitäts-, Konfigurations- oder wiederverwendbare Einstellungen verwendet werden. Mögliche Werte sind: Konfiguration, Compliance, reusableSetting. Für jede Einstellungsverwendung muss ein separater API-Endpunkt aufgerufen werden. Schreibgeschützt. Mögliche Werte: 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 201 Created Antwortcode und das Objekt deviceManagementConfigurationCategory im Antworttext zurückgegeben.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceManagement/inventoryCategories
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 201 Created
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"
  ]
}