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 Gastbenutzer 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 zulassen, dass Gäste von vorhandenen Mitgliedern von Gruppen eingeladen werden, aber eine einzelne Gruppeneinstellung kann außer Kraft setzen 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.Create a setting object based on a 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 können in einem Update geändert werden.
Einstellung löschen	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"}]
}