Freigeben über


Gruppe aktualisieren

Namespace: microsoft.graph

Aktualisiert die Eigenschaften eines Gruppenobjekts.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp Berechtigungen mit den geringsten Berechtigungen Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto) Group.ReadWrite.All Directory.ReadWrite.All
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Anwendung Group.ReadWrite.All Directory.ReadWrite.All

HTTP-Anforderung

PATCH /groups/{id}

Anforderungsheader

Name Typ Beschreibung
Authorization string Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie im Anforderungstext nur die Werte für die Eigenschaften 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.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Eigenschaft Typ Beschreibung
allowExternalSenders Boolesch Der Standardwert ist false. Gibt an, ob Personen außerhalb der Organisation Nachrichten an die Gruppe senden können.
assignedLabels assignedLabel-Sammlung Die Liste der Vertraulichkeitsbezeichnungspaare (Bezeichnungs-ID, Bezeichnungsname), die einer Office 365-Gruppe zugeordnet sind.
autoSubscribeNewMembers Boolesch Der Standardwert ist false. Gibt an, ob neu zur Gruppe hinzugefügte Mitglieder automatisch für E-Mail-Benachrichtigungen abonniert werden. autoSubscribeNewMembers kann nicht true sein, wenn subscriptionEnabled auf der Gruppe auf false festgelegt ist.
description String Eine optionale Beschreibung für die Gruppe.
displayName Zeichenfolge Der Anzeigename der Gruppe. Diese Eigenschaft ist beim Erstellen einer Gruppe erforderlich und kann bei Updates nicht deaktiviert werden.
mailNickname Zeichenfolge Der E-Mail-Alias für die Gruppe, eindeutig für Microsoft 365-Gruppen in der Organisation. Die maximale Länge beträgt 64 Zeichen. Diese Eigenschaft darf nur Zeichen im ASCII-Zeichensatz 0 bis 127 mit Ausnahme der folgenden enthalten: @ () \ [] " ; : . <> , SPACE.
preferredDataLocation Zeichenfolge Der bevorzugte Datenspeicherort für die Microsoft 365-Gruppe. Um diese Eigenschaft zu aktualisieren, muss dem aufrufenden Benutzer mindestens eine der folgenden Microsoft Entra-Rollen zugewiesen sein:
  • Benutzerkontoadministrator
  • Verzeichnisschreibberechtigter
  • Exchange-Administrator
  • SharePoint-Administrator

Weitere Informationen zu dieser Eigenschaft finden Sie unter OneDrive Online Multi-Geo.
securityEnabled Boolean Gibt an, ob es sich bei der Gruppe um eine Sicherheitsgruppe handelt.
uniqueName Zeichenfolge Der eindeutige Bezeichner, der einer Gruppe zugewiesen und als Alternativer Schlüssel verwendet werden kann. Kann nur aktualisiert werden, wenn null und nach dem Festlegen unveränderlich ist.
visibility String Gibt die Sichtbarkeit einer Microsoft 365-Gruppe an. Die folgenden Werte sind möglich: Private, Public oder leer (als Public interpretiert).

Wichtig

  • Um die folgenden Eigenschaften zu aktualisieren, müssen Sie sie in ihrer eigenen PATCH-Anforderung angeben, ohne die anderen in der vorherigen Tabelle aufgeführten Eigenschaften einzufügen: allowExternalSenders, autoSubscribeNewMembers, hideFromAddressLists, hideFromOutlookClients, isSubscribedByMail, unseenCount.
  • Nur eine Teilmenge der Gruppen-API, die sich auf die Hauptgruppenverwaltung und -verwaltung bezieht, unterstützt Anwendungs- und delegierte Berechtigungen. Alle anderen Mitglieder der Gruppen-API, einschließlich der Aktualisierung von autoSubscribeNewMembers, unterstützen nur delegierte Berechtigungen.
  • 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.
  • Anwendungsberechtigungen werden beim Aktualisieren von assignedLabels nicht unterstützt.

Erweiterungen und zugehörige Daten verwalten

Diese API verwenden, um das Verzeichnis, Schema und offene Erweiterungen und ihre Daten für Gruppen wie folgt zu verwalten:

  • Hinzufügen, Aktualisieren und Speichern von Daten in den Erweiterungen für eine vorhandene Gruppe.
  • Bei Verzeichnis und Schemaerweiterungen alle gespeicherten Daten entfernen, indem Sie den Wert der benutzerdefinierten Erweiterungseigenschaft auf null. Für offene Erweiterungen die API zum Löschen offener Erweiterungen verwenden.

Antwort

Bei Erfolg wird diese Methode einen 204 No Content-Antwortcode zurückgeben, mit Ausnahme eines 200 OK-Antwortcodes beim Aktualisieren der folgenden Eigenschaften: allowExternalSenders, autoSubscribeNewMembers, hideFromAddressLists, hideFromOutlookClients, isSubscribedByMail, unseenCount.

Beispiel

Das folgende Beispiel zeigt, wie Sie eine Gruppe aktualisieren.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/v1.0/groups/0d09007d-45b2-458c-b180-880dde3a302e
Content-type: application/json

{
  "description": "Library Assist - ADC",
  "displayName": "Library Assist - ADC",
  "mailNickname": "library-help-adc"
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content