Freigeben über


messageRule-Ressourcentyp

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 eine Regel dar, die für Nachrichten im Posteingang eines Benutzers gilt.

In Outlook können Sie Regeln für eingehende Nachrichten im Posteingang festlegen, um bestimmte Aktionen bei bestimmten Bedingungen auszuführen.

Programmgesteuert können Sie über die messageRules-Navigationseigenschaft des Posteingangsordners auf Regeln zugreifen. Jede Regel wird von dieser messageRule-Ressource dargestellt, verfügbare Regelaktionen werden von dem komplexen Typ messageRuleActions dargestellt, und verfügbare Regelbedingungen und -ausnahmen werden von dem komplexen Typ messageRulePredicates dargestellt.

Methoden

Methode Rückgabetyp Beschreibung
Auflisten von Regeln messageRule-Sammlung Ruft alle messageRule-Objekte ab, die für das Postfach des Benutzers definiert sind.
Regel abrufen messageRule Lesen der Eigenschaften und Beziehungen eines messageRule-Objekts.
Regel erstellen messageRule Erstellen Sie ein messageRule-Objekt, indem Sie eine Gruppe von Bedingungen und Aktionen angeben.
Regel aktualisieren messageRule Ändern Sie die schreibbaren Eigenschaften in einem messageRule-Objekt, und speichern Sie die Änderungen.
Regel löschen Keine Löschen des angegebenen messageRule-Objekts.

Eigenschaften

Eigenschaft Typ Beschreibung
Aktionen messageRuleActions Aktionen, die auf eine Nachricht angewendet werden, wenn die entsprechenden Bedingungen erfüllt sind.
Bedingungen messageRulePredicates Bedingungen, die bei Erfüllung die entsprechenden Aktionen für diese Regel auslösen.
displayName Zeichenfolge Der Anzeigename der Regel.
Ausnahmen messageRulePredicates Ausnahmebedingungen für die Regel.
hasError Boolescher Wert Gibt an, ob sich die Regel in einem Fehlerzustand befindet. Schreibgeschützt.
id Zeichenfolge Der eindeutige Bezeichner der Regel. Schreibgeschützt.
isEnabled Boolescher Wert Gibt an, ob die Regel auf Nachrichten angewendet werden kann.
isReadOnly Boolescher Wert Gibt an, ob die Regel schreibgeschützt ist und von der Regel-REST-API nicht geändert oder gelöscht werden kann.
sequence Int32 Gibt die Reihenfolge an, in der die Regel zusammen mit anderen Regeln ausgeführt wird.

JSON-Darstellung

Die folgende JSON-Darstellung zeigt den Ressourcentyp.

{
  "actions": {"@odata.type": "microsoft.graph.messageRuleActions"},
  "conditions": {"@odata.type": "microsoft.graph.messageRulePredicates"},
  "displayName": "String",
  "exceptions": {"@odata.type": "microsoft.graph.messageRulePredicates"},
  "hasError": "Boolean",
  "id": "String",
  "isEnabled": "Boolean",
  "isReadOnly": "Boolean",
  "sequence": "Int32"
}