deviceManagementConfigurationSettingDefinition erstellen

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 deviceManagementConfigurationSettingDefinition-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 "deviceManagementConfigurationSettingDefinition" an.

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

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

Antwort

Bei erfolgreicher Ausführung gibt die Methode einen 201 Created Antwortcode und ein deviceManagementConfigurationSettingDefinition-Objekt 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: 1260

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingDefinition",
  "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"
}

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

{
  "@odata.type": "#microsoft.graph.deviceManagementConfigurationSettingDefinition",
  "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": "7af649e5-49e5-7af6-e549-f67ae549f67a",
  "description": "Description value",
  "helpText": "Help Text value",
  "name": "Name value",
  "displayName": "Display Name value",
  "version": "Version value"
}