Erstellen von deviceManagementCollectionSettingDefinition

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 deviceManagementCollectionSettingDefinition-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/settingDefinitions
POST /deviceManagement/categories/{deviceManagementSettingCategoryId}/settingDefinitions
POST /deviceManagement/intents/{deviceManagementIntentId}/categories/{deviceManagementIntentSettingCategoryId}/settingDefinitions
POST /deviceManagement/templates/{deviceManagementTemplateId}/categories/{deviceManagementTemplateSettingCategoryId}/settingDefinitions

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 DeviceManagementCollectionSettingDefinition-Objekt an.

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

Eigenschaft	Typ	Beschreibung
id	String	Die ID der Einstellungsdefinition, die von deviceManagementSettingDefinition geerbt wurde
Valuetype	deviceManangementIntentValueType	Der Datentyp des von deviceManagementSettingDefinition geerbten Werts. Mögliche Werte sind: integer, boolean, string, complex, collection und abstractComplex.
displayName	String	Der Anzeigename der Einstellung, geerbt von deviceManagementSettingDefinition
isTopLevel	Boolesch	Wenn es sich bei der Einstellung um die oberste Ebene handelt, kann sie konfiguriert werden, ohne dass sie in eine Sammlung oder eine komplexe Einstellung eingeschlossen werden muss, die von deviceManagementSettingDefinition geerbt wird.
description	String	Die Beschreibung der Einstellung geerbt von deviceManagementSettingDefinition
placeholderText	String	Platzhaltertext als Beispiel für eine gültige Eingabe, die von deviceManagementSettingDefinition geerbt wurde
documentationUrl	String	URL zur Einstellung der Dokumentation Geerbt von deviceManagementSettingDefinition
headerTitle	String	Der Titel des Einstellungsheaders stellt eine Kategorie/einen Abschnitt einer Einstellung/einstellungen dar, die von deviceManagementSettingDefinition geerbt wurde.
headerSubtitle	String	Untertitel des Einstellungsheaders für weitere Details zur Kategorie/zum Abschnitt Geerbt von deviceManagementSettingDefinition
"keywords"	String-Sammlung	Schlüsselwörter, die der Einstellung "Geerbt von deviceManagementSettingDefinition" zugeordnet sind
Einschränkungen	deviceManagementConstraint-Sammlung	Sammlung von Einschränkungen für den Einstellungswert Geerbt von deviceManagementSettingDefinition
Abhängigkeiten	deviceManagementSettingDependency-Sammlung	Sammlung von Abhängigkeiten von anderen Einstellungen geerbt von deviceManagementSettingDefinition
elementDefinitionId	String	Die Einstellungsdefinitions-ID, die beschreibt, wie jedes Element der Sammlung aussieht.

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und ein objekt des Typs deviceManagementCollectionSettingDefinition im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

POST https://graph.microsoft.com/beta/deviceManagement/settingDefinitions
Content-type: application/json
Content-length: 1081

{
  "@odata.type": "#microsoft.graph.deviceManagementCollectionSettingDefinition",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "headerTitle": "Header Title value",
  "headerSubtitle": "Header Subtitle value",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ],
  "elementDefinitionId": "Element Definition Id 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: 1130

{
  "@odata.type": "#microsoft.graph.deviceManagementCollectionSettingDefinition",
  "id": "0419c4a7-c4a7-0419-a7c4-1904a7c41904",
  "valueType": "boolean",
  "displayName": "Display Name value",
  "isTopLevel": true,
  "description": "Description value",
  "placeholderText": "Placeholder Text value",
  "documentationUrl": "https://example.com/documentationUrl/",
  "headerTitle": "Header Title value",
  "headerSubtitle": "Header Subtitle value",
  "keywords": [
    "Keywords value"
  ],
  "constraints": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
      "supportedTypes": [
        "Supported Types value"
      ]
    }
  ],
  "dependencies": [
    {
      "@odata.type": "microsoft.graph.deviceManagementSettingDependency",
      "definitionId": "Definition Id value",
      "constraints": [
        {
          "@odata.type": "microsoft.graph.deviceManagementSettingAppConstraint",
          "supportedTypes": [
            "Supported Types value"
          ]
        }
      ]
    }
  ],
  "elementDefinitionId": "Element Definition Id value"
}