Erstellen oder Aktualisieren von ownerlessGroupPolicy

Namespace: microsoft.graph

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

Um die Richtlinie zu deaktivieren, legen Sie isEnabled auf fest false. Das Festlegen von isEnabled auf false löscht die Werte aller anderen Richtlinienparameter.

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

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.

HTTP-Anforderung

PATCH /policies/ownerlessGroupPolicy

Anforderungsheader

Anforderungstext

Geben Sie im Anforderungstext eine JSON-Darstellung des ownerlessGroupPolicy-Objekts an. Alle erforderlichen Eigenschaften müssen sowohl für Erstellungs- als auch für Aktualisierungsvorgänge bereitgestellt werden. Die API führt einen vollständigen Ersatz der Richtlinienkonfiguration durch. Im Gegensatz zum Verwaltungsportal wendet die API keine Standardwerte für Eigenschaften an.

Antwort

Bei erfolgreicher Ausführung gibt die 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

Beispiele

Beispiel 1: Erstellen oder Aktualisieren der besitzerlosen Gruppenrichtlinie

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"
  }
}

const options = {
	authProvider,
};

const client = Client.init(options);

const ownerlessGroupPolicy = {
  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'
  }
};

await client.api('/policies/ownerlessGroupPolicy')
	.version('beta')
	.update(ownerlessGroupPolicy);

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 besitzerlosen Gruppenrichtlinie

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

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

{
  "isEnabled": false
}

const options = {
	authProvider,
};

const client = Client.init(options);

const ownerlessGroupPolicy = {
  isEnabled: false
};

await client.api('/policies/ownerlessGroupPolicy')
	.version('beta')
	.update(ownerlessGroupPolicy);

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": []
  }
}