directorySetting-Ressourcentyp

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

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

Standardmäßig erben alle Entitäten die voreingestellten Standardwerte. Um die Standardeinstellungen zu ändern, müssen Sie mithilfe von directorySettingTemplates ein neues Einstellungsobjekt erstellen. Wenn dieselbe Einstellung sowohl für die mandantenweite als auch für eine bestimmte Gruppe definiert ist, setzt die Einstellung auf Entitätsebene die mandantenweite Einstellung außer Kraft. Beispielsweise kann die mandantenweite Einstellung vorhandenen Mitgliedern von Gruppen erlauben, Gäste einzuladen. aber eine einzelne Gruppeneinstellung kann den Vorgang außer Kraft setzen und nicht zulassen.

Gruppenspezifische Einstellungen gelten nur für Microsoft 365-Gruppen.

Tipp

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

Methoden

Methode	Rückgabetyp	Beschreibung
List	directorySetting collection	Listet Eigenschaften aller Einstellungsobjekte auf.
Create	directorySetting	Erstellen Sie ein Einstellungsobjekt basierend auf einer directorySettingTemplate.Create a setting object based on a directorySettingTemplate.
Get	directorySetting	Dient zum Lesen der Eigenschaften eines bestimmten Einstellungsobjekts.
Update	directorySetting	Aktualisiert ein Einstellungsobjekt. Nur settingValues können in einem Update geändert werden.
Delete	Keine	Löscht ein Einstellungsobjekt.

Eigenschaften

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

Beziehungen

Keine

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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