groupSetting-Ressourcentyp

Namespace: microsoft.graph

Gruppeneinstellungen 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 Gruppen die voreingestellten Standardwerte. Um die Standardeinstellungen zu ändern, müssen Sie mithilfe von groupSettingTemplates ein neues Einstellungsobjekt erstellen. Wenn dieselbe Einstellung sowohl mandantenweit als auch für eine bestimmte Gruppe definiert ist, setzt die Einstellung auf Gruppenebene 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 setzen und nicht zulassen, dass Gäste von Mitgliedern der Gruppe eingeladen werden.

Gruppeneinstellungen gelten nur für Microsoft 365-Gruppen.

Tipp

Die /beta Version dieser Ressource heißt directorySetting.

Methoden

Methode	Rückgabetyp	Beschreibung
Einstellung erstellen	groupSetting	Erstellen Sie ein Einstellungsobjekt basierend auf einer groupSettingTemplate.
Einstellung abrufen	groupSetting	Dient zum Lesen der Eigenschaften eines bestimmten Einstellungsobjekts.
Einstellungen auflisten	groupSetting-Sammlung	Listet Eigenschaften aller Einstellungsobjekte auf.
Einstellung aktualisieren	groupSetting	Aktualisieren Sie das groupsetting-Objekt.
Einstellung löschen	Keine	Löscht ein Einstellungsobjekt.

Eigenschaften

Eigenschaft	Typ	Beschreibung
displayName	String	Anzeigename dieser Gruppe von Einstellungen, die aus der zugeordneten Vorlage stammt.
id	String	Eindeutiger Bezeichner für diese Einstellungen. Schreibgeschützt.
templateId	String	Eindeutiger Bezeichner für das groupSettingTemplates-Objekt auf Mandantenebene, das für dieses Einstellungsobjekt auf Gruppenebene angepasst wurde. Schreibgeschützt.
values	settingValue-Sammlung	Auflistung von Name-Wert-Paaren, die den Eigenschaften name und defaultValue im groupSettingTemplates-Objekt entsprechen, auf das verwiesen wird.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

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