Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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"}]
}