Erstellen von Einstellungen

Namespace: microsoft.graph

Erstellen Sie eine neue Einstellung basierend auf den vorlagen, die in groupSettingTemplates verfügbar sind. Diese Einstellungen können auf Mandantenebene oder auf Gruppenebene erfolgen.

Gruppeneinstellungen gelten nur für Microsoft 365 Gruppen. Die benannte Group.Unified Vorlage kann verwendet werden, um mandantenweite Microsoft 365 Gruppeneinstellungen zu konfigurieren, während die benannte Group.Unified.Guest Vorlage zum Konfigurieren gruppenspezifischer Einstellungen verwendet werden kann.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto) Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt
Anwendung Directory.ReadWrite.All

HTTP-Anforderung

Erstellen Sie eine mandantenweite Einstellung.

POST /groupSettings

Erstellen Sie eine gruppenspezifische Einstellung.

POST /groups/{id}/settings

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich.
Content-Type application/json

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des groupSetting-Objekts an. Der Anzeigename, die TemplateId und die Beschreibung werden vom referenzierten groupSettingTemplates-Objekt geerbt. Nur die Werteigenschaft kann vom Standardwert geändert werden.

Die folgenden Eigenschaften sind beim Erstellen des groupSetting-Objekts erforderlich.

Parameter Typ Beschreibung
templateId Zeichenfolge Eindeutiger Bezeichner für das groupSettingTemplates-Objekt auf Mandantenebene, das zum Erstellen dieses Einstellungsobjekts auf Gruppenebene verwendet wird. Schreibgeschützt.
values settingValue-Auflistung Auflistung von Name-Wert-Paaren, die den Eigenschaften "name " und "defaultValue " im referenzierten groupSettingTemplates-Objekt entsprechen.

Antwort

Wenn erfolgreich ausgeführt, gibt diese Methode den Antwortcode 201 Created und das groupSetting-Objekt im Antworttext zurück.

Beispiel 1: Erstellen einer neuen Einstellung für alle Microsoft 365 Gruppen im Mandanten

Anforderung

Nur das benannte Group.Unified groupSettingTemplates-Objekt kann auf alle Microsoft 365 Gruppen auf Mandantenebene angewendet werden.

POST https://graph.microsoft.com/v1.0/groupSettings
Content-type: application/json

{
    "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
    "values": [
        {
            "name": "GuestUsageGuidelinesUrl",
            "value": "https://privacy.contoso.com/privacystatement"
        },
        {
            "name": "EnableMSStandardBlockedWords",
            "value": "true"
        },
        {
            "name": "EnableMIPLabels",
            "value": "true"
        },
        {
            "name": "PrefixSuffixNamingRequirement",
            "value": "[Contoso-][GroupName]"
        }
    ]
}

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettings/$entity",
    "id": "844d252c-4de2-43eb-a784-96df77231aae",
    "displayName": null,
    "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
    "values": [
        {
            "name": "GuestUsageGuidelinesUrl",
            "value": "https://privacy.contoso.com/privacystatement"
        },
        {
            "name": "EnableMSStandardBlockedWords",
            "value": "true"
        },
        {
            "name": "EnableMIPLabels",
            "value": "true"
        },
        {
            "name": "PrefixSuffixNamingRequirement",
            "value": "[Contoso-][GroupName]"
        }
    ]
}

Die displayName-Eigenschaft und andere Name-Wert-Paare werden mit den Standardwerten aus dem groupSettingTemplates-Objekt aufgefüllt, das der templateId entspricht.

Beispiel 2: Erstellen einer Einstellung zum Blockieren von Gästen für eine bestimmte Microsoft 365 Gruppe

Anforderung

Nur das benannte Group.Unified.Guest groupSettingTemplates-Objekt kann auf bestimmte Microsoft 365 Gruppen angewendet werden.

POST https://graph.microsoft.com/v1.0/groups/055a5d18-a3a9-4338-b9c5-de92559b7ebf/settings
Content-type: application/json

{
    "templateId": "08d542b9-071f-4e16-94b0-74abb372e3d9",
    "values": [
        {
            "name": "AllowToAddGuests",
            "value": "false"
        }
    ]
}

Geben Sie im Anforderungstext eine JSON-Darstellung des groupSetting-Objekts an.

Antwort

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 201 Created
Content-type: application/json

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groupSettings/$entity",
    "id": "a06fa228-3042-4662-bd09-33e298da1afe",
    "displayName": null,
    "templateId": "08d542b9-071f-4e16-94b0-74abb372e3d9",
    "values": [
        {
            "name": "AllowToAddGuests",
            "value": "false"
        }
    ]
}