mailboxProtectionRule-Ressourcentyp

Artikel
10/25/2024

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.

Stellt die Eigenschaften einer Schutzregel dar, die einer Exchange-Schutzrichtlinie zugeordnet ist.

Erbt von protectionRuleBase.

Methoden

Methode	Rückgabetyp	Beschreibung
List	mailboxProtectionRule-Sammlung	Ruft eine Liste der mailboxProtectionRule-Objekte und deren Eigenschaften ab.
Create	mailboxProtectionRule	Erstellen Sie eine neue mailboxProtectionRule.
Get	mailboxProtectionRule	Lesen der Eigenschaften und Beziehungen eines mailboxProtectionRule-Typs.
Löschen	Keine	Löschen sie ein mailboxProtectionRule-Objekt.
Run	protectionRuleBase	Aktivieren sie eine Postfachschutzregel.

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	Zeichenfolge	Der eindeutige Bezeichner der Der Richtlinie zugeordneten Schutzregel.
createdBy	identitySet	Die Identität der Person, die die Regel erstellt hat.
createdDateTime	DateTimeOffset	Das Datum und die Uhrzeit, zu dem die Regel erstellt wurde.
error	publicError	Enthält Fehlerdetails, wenn ein Vorgang für einen Regelausdruck fehlschlägt.
isAutoApplyEnabled	Boolesch	`true` gibt an, dass die Schutzregel dynamisch ist; `false` dass es statisch ist. Statische Regeln werden einmal ausgeführt, während dynamische Regeln alle Änderungen im System überwachen und die Liste der Schutzeinheiten aktualisieren. Derzeit werden nur statische Regeln unterstützt.
lastModifiedBy	identitySet	Identität der Person, die diese Regel zuletzt geändert hat.
lastModifiedDateTime	DateTimeOffset	Zeitstempel der letzten Änderung der Regel.
mailboxExpression	Zeichenfolge	Enthält einen Postfachausdruck. Beispiele finden Sie unter mailboxExpression-Beispiele.
status	protectionRuleStatus	Status der Schutzregel. Mögliche Werte sind: `draft`, `active`, `completed`, `completedWithErrors`, `unknownFutureValue`. Der `draft` Member wird derzeit nicht unterstützt.

mailboxExpression-Beispiele

Die folgende Tabelle zeigt die möglichen Formate für den Postfachausdruck.

Eigenschaft	Operator	Beispiel
`memberOf`	`-any`	`(memberOf -any (group.id -in ['d7f5150a-0c6f-4894-a6a1-6df77b26f375']))`
`group.id`	`-in`	`(memberOf -any (group.id -in ['d7f5150a-0c6f-4894-a6a1-6df77b26f375', '363cdbd0-f091-4644-93e4-64c1020c94d8']))`

protectionRuleStatus-Werte

Member	Beschreibung
Entwurf	Die anfängliche status der Schutzregel bei der Erstellung. Der `draft` Member wird derzeit nicht unterstützt.
aktiv	Die status der Schutzregel bei Verwendung der `/run` API.
abgeschlossen	Die status der Schutzregel, nachdem sie erfolgreich auf die entsprechende Richtlinie angewendet wurde.
completedWithErrors	Die status der Schutzregel, nachdem sie auf die entsprechende Richtlinie angewendet wurde und fehler aufgetreten sind.
unknownFutureValue	Wert des Sentinelwerts für die vervolvbare Enumeration. Nicht verwenden.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.mailboxProtectionRule",
  "id": "String (identifier)",
  "status": "String",
  "createdDateTime": "String (timestamp)",
  "createdBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "lastModifiedDateTime": "String (timestamp)",
  "lastModifiedBy": {
    "@odata.type": "microsoft.graph.identitySet"
  },
  "error": {
    "@odata.type": "microsoft.graph.publicError"
  },
  "isAutoApplyEnabled": "Boolean",
  "mailboxExpression": "String"
}

Freigeben über