Ressourcentyp "distributionList"

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 persönliche Verteilerliste im Postfach des Benutzers dar. Mithilfe einer Verteilerliste können Benutzer E-Mail-Empfänger gruppieren, sodass diese gleichzeitig eine Nachricht an alle Mitglieder senden können, ohne jede Adresse einzeln eingeben zu müssen.

Erbt von outlookItem.

Methoden

Methode Rückgabetyp Beschreibung
List distributionList collection Rufen Sie eine Liste der distributionList-Objekte im Postfach des Benutzers ab.
Create distributionList Erstellen Sie eine neue Verteilerliste im Postfach des Benutzers.
Get distributionList Lesen der Eigenschaften und Beziehungen eines distributionList-Objekts .
Update distributionList Aktualisieren Sie die Eigenschaften eines distributionList-Objekts .
Löschen Keine Löschen Sie ein distributionList-Objekt .
Mitglieder hinzufügen Keine Hinzufügen von Mitgliedern zu einer Verteilerliste.
Löschen von Mitgliedern Keine Entfernen von Mitgliedern aus einer Verteilerliste.
Mitglieder auflisten distributionListMember-Auflistung Abrufen der erweiterten Mitgliederliste einer Verteilerliste.
Mitglied abrufen distributionListMember Abrufen eines einzelnen erweiterten Mitglieds einer Verteilerliste.

Eigenschaften

Eigenschaft Typ Beschreibung
categories String collection Die Kategorien, die der Verteilerliste zugeordnet sind. Geerbt von outlookItem.
changeKey Zeichenfolge Versionsbezeichner, der für die optimistische Parallelitätssteuerung über den If-Match Header verwendet wird. Schreibgeschützt. Geerbt von outlookItem.
createdDateTime DateTimeOffset Das Datum und die Uhrzeit, zu der die Verteilerliste erstellt wurde. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Mitternacht UTC am 1. Januar 2024 ist 2024-01-01T00:00:00Zbeispielsweise. Schreibgeschützt. Geerbt von outlookItem.
displayName Zeichenfolge Der Anzeigename der Verteilerliste.
id Zeichenfolge Der eindeutige Bezeichner für die Verteilerliste. Schreibgeschützt. Geerbt von outlookItem.
lastModifiedDateTime DateTimeOffset Datum und Uhrzeit der letzten Änderung der Verteilerliste. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und wird immer in UTC angegeben. Mitternacht UTC am 1. Januar 2024 ist 2024-01-01T00:00:00Zbeispielsweise. Schreibgeschützt. Geerbt von outlookItem.
members Mitgliedersammlung Die Liste der Mitglieder in der Verteilerliste. Standardmäßig nicht zurückgegeben; verwenden $select=members , um einzuschließen.

Beziehungen

Beziehung Typ Beschreibung
distributionListMembers distributionListMember-Auflistung Die erweiterten Mitglieder der Verteilerliste. Jedes Mitglied enthält detaillierte Informationen, einschließlich aufgelöster E-Mail-Adressen. Schreibgeschützt.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

{
  "@odata.type": "#microsoft.graph.distributionList",
  "id": "string (identifier)",
  "createdDateTime": "string (timestamp)",
  "lastModifiedDateTime": "string (timestamp)",
  "changeKey": "string",
  "categories": [
    "string"
  ],
  "displayName": "string",
  "members": [
    {
      "@odata.type": "microsoft.graph.member"
    }
  ]
}