messageRule-RessourcentypmessageRule resource type

Eine Regel, die auf Nachrichten im Posteingang eines Benutzers angewendet wird.A rule that applies to messages in the Inbox of a user.

In Outlook können Sie Regeln für eingehende Nachrichten im Posteingang festlegen, um bestimmte Aktionen bei bestimmten Bedingungen auszuführen.In Outlook, you can set up rules for incoming messages in the Inbox to carry out specific actions upon certain conditions.

Programmgesteuert können Sie über die messageRules-Navigationseigenschaft des Posteingangsordners auf Regeln zugreifen.Programmatically, you can access rules through the messageRules navigation property of the Inbox folder. 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.Each rule is represented by this messageRule resource, available rule actions are represented by the messageRuleActions complex type, and available rule conditions and exceptions are represented by the messageRulePredicates complex type.

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
Aktionenactions messageRuleActionsmessageRuleActions Aktionen, die auf eine Nachricht angewendet werden, wenn die entsprechenden Bedingungen erfüllt sind.Actions to be taken on a message when the corresponding conditions are fulfilled.
Bedingungenconditions messageRulePredicatesmessageRulePredicates Bedingungen, die bei Erfüllung die entsprechenden Aktionen für diese Regel auslösen.Conditions that when fulfilled, will trigger the corresponding actions for that rule.
displayNamedisplayName ZeichenfolgeString Der Anzeigename der Regel.The display name of the rule.
Ausnahmenexceptions messageRulePredicatesmessageRulePredicates Ausnahmebedingungen für die Regel.Exception conditions for the rule.
hasErrorhasError BooleanBoolean Gibt an, ob sich die Regel in einem Fehlerzustand befindet.Indicates whether the rule is in an error condition. Schreibgeschützt.Read-only.
idid StringString Der eindeutige Bezeichner der Regel.The unique identifier of the rule. Schreibgeschützt.Read-only.
isEnabledisEnabled Boolescher WertBoolean Gibt an, ob die Regel auf Nachrichten angewendet werden kann.Indicates whether the rule is enabled to be applied to messages.
isReadOnlyisReadOnly Boolescher WertBoolean Gibt an, ob die Regel schreibgeschützt ist und von der Regel-REST-API nicht geändert oder gelöscht werden kann.Indicates if the rule is read-only and cannot be modified or deleted by the rules REST API.
sequencesequence Int32Int32 Gibt die Reihenfolge an, in der die Regel zusammen mit anderen Regeln ausgeführt wird.Indicates the order in which the rule is executed, among other rules.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

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

MethodenMethods

MethodeMethod RückgabetypReturn Type BeschreibungDescription
Auflisten von RegelnList rules messageRule-SammlungmessageRule collection Ruft alle messageRule-Objekte ab, die für das Postfach des Benutzers definiert sind.Get all the messageRule objects defined for the user's Inbox.
Regel abrufenGet rule messageRulemessageRule Lesen der Eigenschaften und Beziehungen eines messageRule-Objekts.Read the properties and relationships of a messageRule object.
ErstellenCreate messageRulemessageRule Erstellen Sie ein messageRule-Objekt, indem Sie eine Gruppe von Bedingungen und Aktionen angeben.Create a messageRule object by specifying a set of conditions and actions.
UpdateUpdate messageRulemessageRule Ändern Sie die schreibbaren Eigenschaften in einem messageRule-Objekt, und speichern Sie die Änderungen.Change writable properties on a messageRule object and save the changes.
DeleteDelete KeineNone Löschen des angegebenen messageRule-Objekts.Delete the specified messageRule object.