Löschen einer Gruppeneinstellung
Namespace: microsoft.graph
Löschen sie ein objekt auf Mandantenebene oder ein gruppenspezifisches groupSetting-Objekt .
Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.
Globaler Dienst | US Government L4 | US Government L5 (DOD) | China, betrieben von 21Vianet |
---|---|---|---|
✅ | ✅ | ✅ | ✅ |
Berechtigungen
Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie unter Berechtigungen.
Für alle Einstellungen mit Ausnahme des Objekts Zustimmungsrichtlinieneinstellungen
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 |
Für das Objekt Zustimmungsrichtlinieneinstellungen
Die folgenden Berechtigungen sind erforderlich, um das DirectorySetting-Objekt "Zustimmungsrichtlinieneinstellungen" zu aktualisieren.
Berechtigungstyp | Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten) |
---|---|
Delegiert (Geschäfts-, Schul- oder Unikonto) | Policy.ReadWrite.Authorization |
Delegiert (persönliches Microsoft-Konto) | Nicht unterstützt |
Anwendung | Policy.ReadWrite.Authorization |
In delegierten Szenarien mit Geschäfts-, Schul- oder Unikonten muss dem angemeldeten Benutzer eine unterstützte Microsoft Entra-Rolle oder eine benutzerdefinierte Rolle mit einer unterstützten Rollenberechtigung zugewiesen werden. Die folgenden Rollen mit den geringsten Berechtigungen werden für diesen Vorgang unterstützt.
Microsoft Entra-Rolle | Zulässige Berechtigungen |
---|---|
Lokaler Administrator für in Microsoft Entra eingebundenes Gerät Verzeichnisleser Globaler Leser |
Grundlegende Eigenschaften zum Festlegen von Vorlagen und Einstellungen lesen |
Gruppenadministrator Verzeichnisautoren |
Verwalten aller Gruppeneinstellungen |
Authentifizierungsrichtlinienadministrator | Aktualisieren Password Rule Settings |
Benutzeradministrator | Grundlegende Eigenschaften zum Festlegen von Vorlagen und Einstellungen lesen Einstellungen aktualisieren |
HTTP-Anforderung
Löschen sie eine mandantenweite Einstellung.
DELETE /groupSettings/{groupSettingId}
Löschen sie eine gruppenspezifische Einstellung.
DELETE /groups/{groupId}/settings/{groupSettingId}
Anforderungsheader
Name | Beschreibung |
---|---|
Authorization | Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung. |
Content-Type | application/json |
Anforderungstext
Geben Sie keinen Anforderungstext für diese Methode an.
Antwort
Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No Content
zurückgegeben. Es gibt nichts im Antworttext zurück.
Beispiel
Anforderung
In diesem Beispiel löschen Sie das Gruppeneinstellungsobjekt auf Mandantenebene.
DELETE https://graph.microsoft.com/v1.0/groupSettings/{id}
Antwort
HTTP/1.1 204 No Content