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. Beispiele: Sie können 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 ein neues Einstellungsobjekt mithilfe der groupSettingTemplates erstellen. Wenn die gleiche Einstellung sowohl für den gesamten Mandanten 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 gesetzt werden 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	Dient zum Aktualisieren des groupsetting-Objekts.
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.
id	Zeichenfolge	Eindeutiger Bezeichner für diese Einstellungen. Schreibgeschützt.
templateId	Zeichenfolge	Eindeutiger Bezeichner für das groupSettingTemplates-Objekt auf Mandantenebene, das für dieses Einstellungsobjekt auf Gruppenebene angepasst wurde. Schreibgeschützt.
values	settingValue-Auflistung	Auflistung von Name-Wert-Paaren, die den Eigenschaften "name " und " defaultValue " im referenzierten groupSettingTemplates-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" }]
}