Erstellen oder Aktualisieren von besitzerloser Gruppenrichtlinie

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Erstellen oder aktualisieren Sie die ownerlessGroupPolicy für den Mandanten. Wenn die Richtlinie nicht vorhanden ist, wird eine neue erstellt. Wenn die Richtlinie vorhanden ist, wird die vorhandene Richtlinie aktualisiert.

Um die Richtlinie zu deaktivieren, legen Sie "isEnabled" auf falsefest. Die Einstellung isEnabled löscht false die Werte aller anderen Richtlinienparameter.

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

Weltweiter Service US Government L4 US Government L5 (DOD) China, betrieben von 21Vianet
✅ ❌ ❌ ❌

Berechtigungen

Wählen Sie die Berechtigungen aus, die für diese API als am wenigsten privilegiert markiert sind. Verwenden Sie eine höhere Berechtigung oder Berechtigungen nur, wenn Ihre App dies erfordert. 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 Nicht verfügbar.
Delegiert (persönliches Microsoft-Konto) Nicht unterstützt Nicht unterstützt
Application Nicht unterstützt Nicht unterstützt

Wichtig

In delegierten Szenarien muss dem aufrufenden Benutzer die Rollen Gruppenadministrator oder Exchange-AdministratorMicrosoftEntra zugewiesen werden.

HTTP-Anforderung

PATCH /policies/ownerlessGroupPolicy

Anforderungsheader

Name Beschreibung
Authorization Bearer {token}. Erforderlich. Erfahren Sie mehr über Authentifizierung und Autorisierung.
Content-Type application/json. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des ownerlessGroupPolicy-Objekts an. Für Erstellungsvorgänge und für Aktualisierungsvorgänge, die die Richtlinie aktivieren oder ihre Konfiguration ändern, müssen alle erforderlichen Eigenschaften angegeben werden, da die API einen vollständigen Austausch der Richtlinienkonfiguration vornimmt. Um die Richtlinie zu deaktivieren, können Sie senden, dass nur isEnabled auf festgelegt ist. falseWenn Sie dies tun, löscht der Dienst die Werte aller anderen Richtlinienparameter. Im Gegensatz zum Verwaltungsportal wendet die API für die meisten Eigenschaften keine Standardwerte an, mit Ausnahme von targetOwners, bei dem standardmäßig alle Mitglieder Besitzer werden können.

Eigenschaft Typ Beschreibung
emailInfo emailDetails Die E-Mail-Benachrichtigungsdetails für die Gruppenrichtlinie für die Besitzerlosigkeit. Erforderlich beim Erstellen der Richtlinie oder beim Aktivieren oder Aktualisieren der Richtlinienkonfiguration.
enabledGroupIds String collection Die Sammlung von IDs für Microsoft 365-Gruppen, für die die Richtlinie aktiviert ist. Wenn leer, wird die Richtlinie für alle Gruppen im Mandanten aktiviert. Erforderlich beim Erstellen der Richtlinie oder beim Aktivieren oder Aktualisieren der Richtlinienkonfiguration.
isEnabled Boolescher Wert Gibt an, ob die Gruppenrichtlinie für die Besitzerlosigkeit aktiviert ist. Erforderlich. Durch Festlegen dieser Eigenschaft werden die Werte aller anderen Richtlinienparameter gelöscht. Um die Richtlinie zu false deaktivieren, können Sie nur diese Eigenschaft mit dem Wert falsesenden.
maxMembersToNotify Int64 Die maximale Anzahl von Mitgliedern, die benachrichtigt werden sollen. Der Wertebereich liegt zwischen 0 und 90. Erforderlich beim Erstellen der Richtlinie oder beim Aktivieren oder Aktualisieren der Richtlinienkonfiguration.
notificationDurationInWeeks Int64 Die Anzahl der Wochen für die Benachrichtigungsdauer. Der Wertebereich liegt zwischen 1 und 7. Erforderlich beim Erstellen der Richtlinie oder beim Aktivieren oder Aktualisieren der Richtlinienkonfiguration.
policyWebUrl Zeichenfolge Die URL zur Richtliniendokumentation. Optional.
targetOwners targetOwners Gibt an, welche Mitglieder Besitzer werden können. Wenn nicht angegeben, sind alle Mitglieder teilnahmeberechtigt. Optional.

Antwort

Bei erfolgreicher Ausführung gibt diese Methode einen 200 OK Antwortcode und ein aktualisiertes ownerlessGroupPolicy-Objekt im Antworttext zurück, wenn die Richtlinie bereits vorhanden ist, oder einen 201 Created Antwortcode und ein neues ownerlessGroupPolicy-Objekt im Antworttext, wenn die Richtlinie erstellt wird.

Fehler

Bedingung Statuscode Fehlercode
notificationDurationInWeeks liegt nicht im Bereich 1–7 400 Bad Request (400 ungültige Anforderung) badRequest
maxMembersToNotify liegt nicht im Bereich 0–90 400 Bad Request (400 ungültige Anforderung) badRequest

Beispiele

Beispiel 1: Erstellen oder Aktualisieren der Gruppenrichtlinie für die Besitzerlosigkeit

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/beta/policies/ownerlessGroupPolicy
Content-Type: application/json

{
  "isEnabled": true,
  "notificationDurationInWeeks": 3,
  "maxMembersToNotify": 40,
  "policyWebUrl": "https://contoso.com/policies/ownerless-groups",
  "targetOwners": {
    "notifyMembers": "allowSelected",
    "securityGroups": [
      "security-group1@contoso.com",
      "security-group2@contoso.com"
    ]
  },
  "enabledGroupIds": [
    "b14e5eb2-a0a1-4c8f-b83e-940526219200",
    "454dde77-ac2b-421b-a6ab-165be910e0fc"
  ],
  "emailInfo": {
    "senderEmailAddress": "admin@contoso.com",
    "subject": "Need your help with $Group.Name group",
    "body": "Hi $User.DisplayName, \n\nYou'\''re receiving this email because you'\''ve been an active member of the $Group.Name group. This group currently does not have an owner. \n\nPer your organization'\''s policy, the group requires an owner.\n\nThank you"
  }
}

Antwort

Das folgende Beispiel zeigt die Antwort.

Hinweis: Das hier gezeigte Antwortobjekt kann zur besseren Lesbarkeit gekürzt werden.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.ownerlessGroupPolicy",
  "isEnabled": true,
  "notificationDurationInWeeks": 3,
  "maxMembersToNotify": 40,
  "enabledGroupIds": [
    "b14e5eb2-a0a1-4c8f-b83e-940526219200",
    "454dde77-ac2b-421b-a6ab-165be910e0fc"
  ],
  "emailInfo": {
    "@odata.type": "microsoft.graph.emailDetails",
    "senderEmailAddress": "admin@contoso.com",
    "subject": "Need your help with $Group.Name group",
    "body": "Hi $User.DisplayName, \n\nYou'\''re receiving this email because you'\''ve been an active member of the $Group.Name group. This group currently does not have an owner. \n\nPer your organization'\''s policy, the group requires an owner.\n\nThank you"
  },
  "policyWebUrl": "https://contoso.com/policies/ownerless-groups",
  "targetOwners": {
    "@odata.type": "microsoft.graph.targetOwners",
    "notifyMembers": "allowSelected",
    "securityGroups": [
      "security-group1@contoso.com",
      "security-group2@contoso.com"
    ]
  }
}

Beispiel 2: Deaktivieren der Gruppenrichtlinie für die Besitzerlosigkeit

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

PATCH https://graph.microsoft.com/beta/policies/ownerlessGroupPolicy
Content-Type: application/json

{
  "isEnabled": false
}

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.ownerlessGroupPolicy",
  "isEnabled": false,
  "notificationDurationInWeeks": 0,
  "maxMembersToNotify": 0,
  "enabledGroupIds": [],
  "emailInfo": {
    "@odata.type": "microsoft.graph.emailDetails",
    "senderEmailAddress": "",
    "subject": "",
    "body": ""
  },
  "policyWebUrl": "",
  "targetOwners": {
    "@odata.type": "microsoft.graph.targetOwners",
    "notifyMembers": "all",
    "securityGroups": []
  }
}