directorySetting-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Verzeichniseinstellungen definieren die Konfigurationen, die verwendet werden können, um die mandantenweiten und objektspezifischen Einschränkungen und das zulässige Verhalten anzupassen. Beispiele: Sie können Wortlisten für Gruppenanzeigenamen blockieren oder festlegen, ob Gastbenutzer Gruppenbesitzer sein dürfen.

Standardmäßig erben alle Entitäten die voreingestellten Standardwerte. Um die Standardeinstellungen zu ändern, müssen Sie ein neues Einstellungsobjekt mithilfe der directorySettingTemplates erstellen. Wenn die gleiche Einstellung sowohl für den gesamten Mandanten als auch für eine bestimmte Gruppe definiert ist, setzt die Einstellung auf Entitätsebene die mandantenweite Einstellung außer Kraft. Die mandantenweite Einstellung kann beispielsweise zulassen, dass Gäste von vorhandenen Mitgliedern von Gruppen eingeladen werden, eine einzelne Gruppeneinstellung kann jedoch außer Kraft gesetzt werden und nicht zulassen, dass Gäste von Mitgliedern der Gruppe eingeladen werden.

Tipp

Die /v1.0 Version dieser Ressource heißt "groupSetting".

Methoden

Methode	Rückgabetyp	Beschreibung
Einstellung erstellen	directorySetting	Erstellen Sie ein Einstellungsobjekt basierend auf einer directorySettingTemplate.
Einstellung abrufen	directorySetting	Dient zum Lesen der Eigenschaften eines bestimmten Einstellungsobjekts.
Einstellungen auflisten	directorySetting collection	Listet Eigenschaften aller Einstellungsobjekte auf.
Einstellung aktualisieren	directorySetting	Aktualisiert ein Einstellungsobjekt. Nur settingValues kann in einem Update geändert werden.
Einstellung löschen	Keine	Löscht ein Einstellungsobjekt.

Eigenschaften

Eigenschaft	Typ	Beschreibung
displayName	string	Der Anzeigename dieser Gruppe von Einstellungen, die aus der zugeordneten Vorlage stammt. Schreibgeschützt.
id	string	Eindeutiger Bezeichner für diese Einstellungen. Schreibgeschützt.
templateId	string	Eindeutiger Bezeichner für die Vorlage, die zum Erstellen dieser Gruppe von Einstellungen verwendet wird. Schreibgeschützt.
values	settingValue-Auflistung	Auflistung von Name-Wert-Paaren, die den Eigenschaften "name" und "defaultValue" im referenzierten directorySettingTemplates-Objekt entsprechen.

Beziehungen

Keine

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "displayName": "string",
  "id": "string (identifier)",
  "templateId": "string",
  "values": [{"@odata.type": "microsoft.graph.settingValue"}]
}