Aktualisieren einer GruppeneinstellungUpdate a group setting

Namespace: microsoft.graphNamespace: microsoft.graph

Aktualisieren der Eigenschaften eines groupSetting -Objekts für Mandantenweite Gruppen Einstellungen oder eine bestimmte Gruppeneinstellung.Update the properties of a groupSetting object for tenant-wide group settings or a specific group setting.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) Directory.ReadWrite.All, Directory.AccessAsUser.AllDirectory.ReadWrite.All, Directory.AccessAsUser.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
ApplicationApplication Directory.ReadWrite.AllDirectory.ReadWrite.All

HTTP-AnforderungHTTP request

PATCH /groupSettings/{id}
PATCH /groups/{id}/settings/{id}

AnforderungsheaderRequest headers

NameName BeschreibungDescription
AuthorizationAuthorization {Token}.{token}. Erforderlich.Required.
Content-TypeContent-Type application/jsonapplication/json

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen.In the request body, supply the values for relevant fields that should be updated.

EigenschaftProperty TypType BeschreibungDescription
valuesvalues SettingValue -AuflistungsettingValue collection Die aktualisierte Gruppe von Werten.The updated set of values. Sie müssen den gesamten Sammlungssatzes einschließen.You must include the entire collection set. Es ist nicht möglich, eine einzelne Gruppe von Werten zu aktualisieren.You cannot update a single set of values.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content zurückgegeben.If successful, this method returns a 204 No Content response code.

BeispieleExamples

Beispiel 1: Aktualisieren einer Mandanten weiten GruppeneinstellungExample 1: Update a tenant-wide group setting

In diesem Beispiel {id} ist der Bezeichner des Mandanten weiten groupSetting-Objekts.In this example, {id} is the identifier of the tenant-wide groupSetting object.

AnforderungRequest

PATCH https://graph.microsoft.com/v1.0/groupSettings/{id}
Content-type: application/json

{
  "displayName": "Group.Unified",
  "templateId": "62375ab9-6b52-47ed-826b-58e47e0e304b",
  "values": [
    {
      "name": "EnableMIPLabels",
      "value": "false"
    },
    {
      "name": "CustomBlockedWordsList",
      "value": ""
    },
    {
      "name": "EnableMSStandardBlockedWords",
      "value": "false"
    },
    {
      "name": "ClassificationDescriptions",
      "value": ""
    },
    {
      "name": "DefaultClassification",
      "value": ""
    },
    {
      "name": "PrefixSuffixNamingRequirement",
      "value": ""
    },
    {
      "name": "AllowGuestsToBeGroupOwner",
      "value": "false"
    },
    {
      "name": "AllowGuestsToAccessGroups",
      "value": "true"
    },
    {
      "name": "GuestUsageGuidelinesUrl",
      "value": ""
    },
    {
      "name": "GroupCreationAllowedGroupId",
      "value": ""
    },
    {
      "name": "AllowToAddGuests",
      "value": "true"
    },
    {
      "name": "UsageGuidelinesUrl",
      "value": ""
    },
    {
      "name": "ClassificationList",
      "value": ""
    },
    {
      "name": "EnableGroupCreation",
      "value": "true"
    }
  ]
}

AntwortResponse

HTTP/1.1 204 No Content

Beispiel 2: Aktualisieren einer bestimmten GruppeneinstellungExample 2: Update a specific group setting

In diesem Beispiel ist der erste {id} in der Anforderung der Bezeichner der Gruppe, und der zweite {id} ist der Bezeichner des groupSetting-Objekts.In this example, the first {id} in the request is the identifier of the group, and the second {id} is the identifier of the groupSetting object.

AnforderungRequest

PATCH https://graph.microsoft.com/v1.0/groups/{id}/settings/{id}
Content-type: application/json

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

AntwortResponse

HTTP/1.1 204 No Content