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:
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