Feedback Bearbeiten

deviceManagementConfigurationSettingGroupDefinition erstellen

  • Artikel
  • 3 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig: Microsoft Graph-APIs unter der /beta-Version können geändert werden. Die Produktionsverwendung 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 deviceManagementConfigurationSettingGroupDefinition-Objekt .

Voraussetzungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema 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/reusableSettings
POST /deviceManagement/complianceSettings
POST /deviceManagement/configurationSettings
POST /deviceManagement/configurationPolicies/{deviceManagementConfigurationPolicyId}/settings/{deviceManagementConfigurationSettingId}/settingDefinitions
POST /deviceManagement/configurationPolicyTemplates/{deviceManagementConfigurationPolicyTemplateId}/settingTemplates/{deviceManagementConfigurationSettingTemplateId}/settingDefinitions

Anforderungsheader

Kopfzeile Wert
Authorization Bearer<token> erforderlich
Annehmen application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des Objekts des Typs "deviceManagementConfigurationSettingGroupDefinition" an.

In der folgenden Tabelle sind die Eigenschaften aufgeführt, die angegeben werden müssen, wenn Sie deviceManagementConfigurationSettingGroupDefinition erstellen.

Eigenschaft Typ Beschreibung
Anwendbarkeit deviceManagementConfigurationSettingApplicability Details, welche Geräteeinstellung auf "Geerbt von deviceManagementConfigurationSettingDefinition" anwendbar ist
accessTypes deviceManagementConfigurationSettingAccessTypes Lese-/Schreibzugriffsmodus der Einstellung Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte: none, add, copy, delete, get, replace, execute.
"keywords" String collection Token, die Einstellungen für "Geerbt von deviceManagementConfigurationSettingDefinition" durchsuchen
infoUrls String collection Liste der Links weitere Informationen zu der Einstellung finden Sie unter Geerbt von deviceManagementConfigurationSettingDefinition
Vorkommen deviceManagementConfigurationSettingOccurrence Gibt an, ob die Einstellung erforderlich ist oder nicht Geerbt von deviceManagementConfigurationSettingDefinition
Baseuri String Base CSP Path Inherited from deviceManagementConfigurationSettingDefinition
offsetUri String Offset CSP Path from Base Inherited from deviceManagementConfigurationSettingDefinition
rootDefinitionId Zeichenfolge Definition der Stammeinstellung, wenn es sich bei der Einstellung um eine untergeordnete Einstellung handelt. Geerbt von deviceManagementConfigurationSettingDefinition
Categoryid Zeichenfolge Gibt die Bereichsgruppe an, unter der die Einstellung in einem angegebenen Konfigurationsdienstanbieter (CSP) konfiguriert wird, geerbt von deviceManagementConfigurationSettingDefinition
settingUsage deviceManagementConfigurationSettingUsage Einstellungstyp, z. B. Konfiguration und Compliance Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte sind: none, configuration und compliance.
uxBehavior deviceManagementConfigurationControlType Festlegen der Steuerelementtypdarstellung in der UX Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte: default, dropdown, smallTextBox, largeTextBox, toggle, multiheaderGrid, contextPane.
visibility deviceManagementConfigurationSettingVisibility Festlegen des Sichtbarkeitsbereichs auf UX Geerbt von deviceManagementConfigurationSettingDefinition. Mögliche Werte sind: none, settingsCatalog und template.
referredSettingInformationList deviceManagementConfigurationReferredSettingInformation-Sammlung Liste der informationen zu den genannten Einstellungen. Geerbt von deviceManagementConfigurationSettingDefinition
id String Bezeichner für element Geerbt von deviceManagementConfigurationSettingDefinition
description Zeichenfolge Beschreibung des Elements Geerbt von deviceManagementConfigurationSettingDefinition
Helptext Zeichenfolge Hilfetext des Elements Geerbt von deviceManagementConfigurationSettingDefinition
name Zeichenfolge Name des Elements Geerbt von deviceManagementConfigurationSettingDefinition
displayName String Anzeigename des Elements Geerbt von deviceManagementConfigurationSettingDefinition
Version String Elementversion Geerbt von deviceManagementConfigurationSettingDefinition
childIds String collection Abhängige untergeordnete Einstellungen für diese Gruppe von Einstellungen
dependentOn deviceManagementConfigurationDependentOn-Sammlung Liste der Abhängigkeiten für die Einstellungsgruppe
dependedOnBy deviceManagementConfigurationSettingDependedOnBy-Sammlung Liste der untergeordneten Einstellungen, die von dieser Einstellung abhängen

Antwort

Bei erfolgreicher Ausführung gibt die Methode den 201 Created Antwortcode und das Objekt "deviceManagementConfigurationSettingGroupDefinition " im Antworttext zurück.

Beispiel

Anforderung

Nachfolgend sehen Sie ein Beispiel der Anforderung.

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ]
}

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingGroupDefinition",
  "applicability": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingApplicability",
    "description": "Description value",
    "platform": "android",
    "deviceMode": "kiosk",
    "technologies": "mdm"
  },
  "accessTypes": "add",
  "keywords": [
    "Keywords value"
  ],
  "infoUrls": [
    "Info Urls value"
  ],
  "occurrence": {
    "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingOccurrence",
    "minDeviceOccurrence": 3,
    "maxDeviceOccurrence": 3
  },
  "baseUri": "Base Uri value",
  "offsetUri": "Offset Uri value",
  "rootDefinitionId": "Root Definition Id value",
  "categoryId": "Category Id value",
  "settingUsage": "configuration",
  "uxBehavior": "dropdown",
  "visibility": "settingsCatalog",
  "referredSettingInformationList": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationReferredSettingInformation",
      "settingDefinitionId": "Setting Definition Id value"
    }
  ],
  "id": "95dc9604-9604-95dc-0496-dc950496dc95",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value",
  "childIds": [
    "Child Ids value"
  ],
  "dependentOn": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationDependentOn",
      "dependentOn": "Dependent On value",
      "parentSettingId": "Parent Setting Id value"
    }
  ],
  "dependedOnBy": [
    {
      "@odata.type": "microsoft.graph.deviceManagementConfigurationSettingDependedOnBy",
      "dependedOnBy": "Depended On By value",
      "required": true
    }
  ]
}