Gruppe aktualisierenUpdate group

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Aktualisieren der Eigenschaften eines Group -Objekts.Update the properties of a group object.

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) Group.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.AllGroup.ReadWrite.All, Directory.ReadWrite.All, Directory.AccessAsUser.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Group.ReadWrite.All, Directory.ReadWrite.AllGroup.ReadWrite.All, Directory.ReadWrite.All

HTTP-AnforderungHTTP request

PATCH /groups/{id}

AnforderungsheaderRequest headers

NameName TypType BeschreibungDescription
AuthorizationAuthorization stringstring Bearer {token}. Erforderlich.Bearer {token}. Required.

AnforderungstextRequest body

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
allowExternalSendersallowExternalSenders Boolescher WertBoolean Der Standardwert ist false. Gibt an, ob Personen außerhalb der Organisation Nachrichten an die Gruppe senden können.Default is false. Indicates if people external to the organization can send messages to the group.
autoSubscribeNewMembersautoSubscribeNewMembers BooleanBoolean Der Standardwert ist false. Zeigt an, ob neu zur Gruppe hinzugefügte Mitglieder automatisch E-Mail-Benachrichtigungen erhalten.Default is false. Indicates if new members added to the group will be auto-subscribed to receive email notifications.
descriptiondescription StringString Eine optionale Beschreibung für die Gruppe.An optional description for the group.
displayNamedisplayName StringString Der Anzeigename der Gruppe. Diese Eigenschaft ist beim Erstellen einer Gruppe erforderlich und kann bei Updates nicht deaktiviert werden.The display name for the group. This property is required when a group is created and it cannot be cleared during updates.
groupTypesgroupTypes ZeichenfolgensammlungString collection Gibt den Typ und die Mitgliedschaft der Gruppe an.Specifies the group type and its membership.

Wenn die Sammlung Unified enthält, dann handelt es sich bei der Gruppe um eine Office 365-Gruppe, andernfalls um eine Sicherheitsgruppe.If the collection contains Unified then the group is an Office 365 group; otherwise it's a security group.

Wenn die Sammlung DynamicMembership enthält, verfügt die Gruppe über eine dynamische Mitgliedschaft, ist die Mitgliedschaft statisch.If the collection includes DynamicMembership, the group has dynamic membership; otherwise, membership is static.
mailEnabledmailEnabled BooleanBoolean Gibt an, ob es sich bei der Gruppe um eine E-Mail-fähige Gruppe handelt.Specifies whether the group is mail-enabled.
mailNicknamemailNickname ZeichenfolgeString Der E-Mail-Alias für die Gruppe.The mail alias for the group. Diese Eigenschaft muss beim Erstellen einer Gruppe angegeben werden.This property must be specified when a group is created.
securityEnabledsecurityEnabled BooleanBoolean Gibt an, ob es sich bei der Gruppe um eine Sicherheitsgruppe handelt, einschließlich Office 365 Gruppen.Specifies whether the group is a security group, including Office 365 groups.
visibilityvisibility ZeichenfolgeString Gibt die Sichtbarkeit einer Office 365-Gruppe an. Die folgenden Werte sind möglich: Private, Public oder leer (als öffentlich interpretiert).Specifies the visibility of an Office 365 group. Possible values are: Private, Public, or empty (which is interpreted as Public).

Da die Group -Ressource Erweiterungenunterstützt, können Sie den PATCH -Vorgang verwenden, um Ihre eigenen App-spezifischen Daten in benutzerdefinierten Eigenschaften einer Erweiterung in einer vorhandenen Gruppen Instanz hinzuzufügen, zu aktualisieren oder zu löschen.Because the group resource supports extensions, you can use the PATCH operation to add, update, or delete your own app-specific data in custom properties of an extension in an existing group instance.

Hinweis:Note:

  • Sie können autoSubscribeNewMembers aktualisieren, indem Sie diese Eigenschaft in ihrer eigenen PATCH-Anforderung angeben, ohne die anderen Eigenschaften in der Tabelle oben einzuschließen.You can update autoSubscribeNewMembers by specifying it in its own PATCH request, without including the other properties in the table above.
  • Nur eine Teilmenge der Gruppen-API, die zur Hauptgruppenadministration und -verwaltung gehören, unterstützen Anwendungs- und delegierte Berechtigungen. Alle anderen Mitglieder der Gruppen-API, einschließlich des Aktualisierens von autoSubscribeNewMembers, unterstützen nur delegierte Berechtigungen. Beispiele finden Sie unter Bekannte Probleme.Only a subset of the group API pertaining to core group administration and management support application and delegated permissions. All other members of the group API, including updating autoSubscribeNewMembers, support only delegated permissions. See known issues for examples.
  • Die Regeln für die Aktualisierung von E-Mail-aktivierten Sicherheitsgruppen in Microsoft Exchange Server können komplex sein. Weitere Informationen finden Sie unter Verwalten von E-Mail-aktivierten Sicherheitsgruppen in Exchange Server.The rules for updating mail-enabled security groups in Microsoft Exchange Server can be complex; to learn more, see Manage mail-enabled security groups in Exchange Server.

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 des Anzeigenamens und der Beschreibung einer GruppeExample 1: Update display name and description of a group

AnforderungRequest

Nachfolgend sehen Sie ein Beispiel der Anforderung.The following is an example of the request.

PATCH https://graph.microsoft.com/beta/groups/{id}
Content-type: application/json
Content-length: 211

{
  "description": "description-value",
  "displayName": "displayName-value",
}

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

HTTP/1.1 204 No Content

Beispiel 2: Anwenden der Sensitivitäts Bezeichnung auf eine Office 365 GruppeExample 2: Apply sensitivity label to an Office 365 group

AnforderungRequest

Sie können die ID der Bezeichnung, die Sie auf eine Office 365 Gruppe anwenden möchten, mithilfe der listenbezeichnungabrufen.You can obtain the ID of the label you want to apply to an Office 365 group by using List label. Anschließend können Sie die assignedLabels -Eigenschaft der Gruppe mit der Label-ID aktualisieren.Then you can update the assignedLabels property of the group with the label ID.

PATCH https://graph.microsoft.com/beta/groups/{id}
Content-type: application/json
Content-length: 211

{
  "assignedLabels": 
  [
    {
        "labelId" : "45cd0c48-c540-4358-ad79-a3658cdc5b88"
    }
  ]
}

AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

HTTP/1.1 204 No Content

Siehe auchSee also