ExpandDL-Vorgang
Der ExpandDL-Vorgang macht die vollständige Mitgliedschaft von Verteilerlisten verfügbar.
Verwenden der ExpandDL-Webmethode
Der ExpandDL-Vorgang verwendet den Webdienst, der sich in Exchange.asmx befindet. Diese Webdienstmethode akzeptiert ein Mailbox-Element , das entweder ein untergeordnetes EmailAddress-Element (NonEmptyStringType) für eine Erweiterung einer öffentlichen Verteilerliste oder ein untergeordnetes ItemId-Element für die Erweiterung einer privaten Verteilerliste enthalten kann.
Öffentliche Verteilerlisten können mithilfe einer der folgenden Optionen erweitert werden:
Verteilerlistenalias
Die SMTP-Adresse (Simple Mail Transfer Protocol)
X400
X500
Exchange Legacy-Adresse
Der Name der Verteilerliste
Der Anzeigename
Wichtig
Anzeigenamen sind nicht eindeutig. Mehrere Konten können denselben Anzeigenamen verwenden.
HinwBemerkungeneise
Die rekursive Erweiterung wird nicht unterstützt. In einem einzigen Aufruf kann nur eine Verteilerliste erweitert werden. Wenn mehrere Verteilerlisten den Kriterien entsprechen, meldet der Webdienst einen Fehler. Eine Clientanwendung kann mehrdeutige Namensauflösung (Ambiguous Name Resolution, ANR) verwenden, um mehrdeutige Verteilerlisten zu finden, und dann die richtige E-Mail-Adresse der erforderlichen Verteilerliste als Parameter für den ExpandDL-Vorgang auswählen. Weitere Informationen finden Sie unter ResolveNames-Vorgang.
Öffentliche Verteilerlisten befinden sich in Active Directory. Dabei kann es sich um eine beliebige E-Mail-aktivierte oder dynamische Verteilergruppe handeln. Die Gruppe sollte nicht in der Adressliste ausgeblendet werden, und jedes Mitglied sollte über eine nicht leere E-Mail-Adresse verfügen. Mitglieder der Verteilerliste können E-Mail-aktivierte Benutzer und Kontakte, öffentliche Ordner und E-Mail-aktivierte Verteilerlisten und dynamische Gruppen sein.
Private Verteilerlisten befinden sich im Ordner Kontakte des Postfachs eines Benutzers. Private Verteilerlisten verfügen über keine E-Mail-Adressen, sodass ihre Store-Elementbezeichner in einer ExpandDL-Anforderung verwendet werden. Mitglieder einer privaten Verteilerliste können E-Mail-aktivierte Benutzer, Kontakte oder Verteilerlisten aus Active Directory oder Kontakte oder private Verteilerlisten aus dem Ordner Kontakte eines Benutzers sein.
Bei Kontakten oder privaten Verteilerlisten werden die Elementbezeichner in der Antwort zurückgegeben. Dies kann verwendet werden, um Informationen zum Objekt abzurufen oder die Mitgliedschaft in einer privaten Verteilerliste zu erweitern.
Beispiel für die Anforderung einer privaten Verteilerliste für ExpandDL
Beschreibung
Das folgende Beispiel einer ExpandDL-Anforderung zeigt, wie eine Anforderung zum Erweitern einer privaten Verteilerliste erstellt wird.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages" xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<t:RequestServerVersion Version="Exchange2013_SP1" />
</soap:Header>
<soap:Body>
<m:ExpandDL>
<m:Mailbox>
<t:EmailAddress>test</t:EmailAddress>
</m:Mailbox>
</m:ExpandDL>
</soap:Body>
</soap:Envelope>
Kommentare
Um eine private Verteilerliste zu erweitern, enthält das Mailbox-Element das Element ItemId , das eine private Verteilerliste im Postfach des Benutzers identifiziert.
Beispiel für die Anforderung einer öffentlichen Verteilerliste für ExpandDL
Beschreibung
Das folgende Beispiel einer ExpandDL-Anforderung zeigt, wie eine Anforderung zum Erweitern einer öffentlichen Verteilerliste zu erstellen ist. Das Beispiel zeigt die Verwendung eines Anzeigenamens zum Erweitern einer Verteilerliste.
Code
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<soap:Body>
<ExpandDL xmlns="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types">
<t:Mailbox>
<t:EmailAddress>TheDistributionList</t:EmailAddress>
</t:Mailbox>
</ExpandDL>
</soap:Body>
</soap:Envelope>
Kommentare
Die Antwort auf diese Anforderung enthält Postfachelemente , die jedes Postfach in der Verteilerliste identifizieren. Wenn eine Verteilerliste in einer Verteilerliste enthalten ist, muss eine separate Verteilerlistenerweiterung für die eingebettete Verteilerliste ausgeführt werden. Wenn die Verteilerliste keine Elemente enthält oder die angeforderte Verteilerliste nicht vorhanden ist, enthält das ResponseClass-Attribut einen Wert, der dem Wert Success entspricht.
Anfordern von Elementen
In der Anforderung werden folgende Elemente verwendet:
EmailAddress (NonEmptyStringType) wird verwendet, um öffentliche Verteilerlisten zu identifizieren. Das ItemId-Element wird verwendet, um private Verteilerlisten zu identifizieren.
Hinweis
Das Schema, das diese Elemente beschreibt, befindet sich im virtuellen EWS-Verzeichnis des Computers, auf dem MicrosoftExchange Server 2007 ausgeführt wird, auf dem die Clientzugriffsserverrolle installiert ist.
Beispiel für eine erfolgreiche ExpandDL-Antwort
Beschreibung
Das folgende Beispiel einer ExpandDL-Antwort zeigt eine Antwort auf die oben beschriebene Anforderung. Die Erweiterung der Verteilerliste beschreibt Folgendes:
Die Anzahl der Mitglieder der Verteilerliste, die in der Antwort zurückgegeben werden.
Gibt an, ob die Antwort alle Elemente der Verteilerliste enthält.
Der Name des Postfachs.
Die E-Mail-Adresse des Postfachs.
Der Routingtyp für das Postfach.
Der Typ des Postfachs.
Hinweis
Der Name der Verteilerliste ist nicht in der Antwort enthalten. Daher müssen Sie den Namen aus der Anforderung nachverfolgen.
Code
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0"
MajorBuildNumber="628" MinorBuildNumber="0"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<ExpandDLResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:ExpandDLResponseMessage ResponseClass="Success">
<m:ResponseCode>NoError</m:ResponseCode>
<m:DLExpansion TotalItemsInView="3" IncludesLastItemInRange="true">
<t:Mailbox>
<t:Name>Dan Park</t:Name>
<t:EmailAddress>dpark@exampledomain.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
<t:MailboxType>Mailbox</t:MailboxType>
</t:Mailbox>
<t:Mailbox>
<t:Name>Jeff Price</t:Name>
<t:EmailAddress>jprice@exampledomain.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
<t:MailboxType>Mailbox</t:MailboxType>
</t:Mailbox>
<t:Mailbox>
<t:Name>Tanja Plate</t:Name>
<t:EmailAddress>tplate@exampledomain.com</t:EmailAddress>
<t:RoutingType>SMTP</t:RoutingType>
<t:MailboxType>Mailbox</t:MailboxType>
</t:Mailbox>
</m:DLExpansion>
</m:ExpandDLResponseMessage>
</m:ResponseMessages>
</ExpandDLResponse>
</soap:Body>
</soap:Envelope>
Erfolgreiche Antwortelemente
In der Antwort werden folgende Elemente verwendet:
Weitere Optionen für die Antwortmeldung des ExpandDL-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie mit dem ExpandDLResponse-Element .
ExpandDL-Fehlerantwort
Beschreibung
Das folgende Beispiel zeigt eine Fehlerantwort auf eine ExpandDL-Anforderung.
Code
<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<soap:Header>
<t:ServerVersionInfo MajorVersion="8" MinorVersion="0"
MajorBuildNumber="628" MinorBuildNumber="0"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types" />
</soap:Header>
<soap:Body>
<ExpandDLResponse xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages"
xmlns:t="http://schemas.microsoft.com/exchange/services/2006/types"
xmlns="http://schemas.microsoft.com/exchange/services/2006/messages">
<m:ResponseMessages>
<m:ExpandDLResponseMessage ResponseClass="Error">
<m:MessageText>No results are found.</m:MessageText>
<m:ResponseCode>ErrorNameResolutionNoResults</m:ResponseCode>
<m:DescriptiveLinkKey>0</m:DescriptiveLinkKey>
</m:ExpandDLResponseMessage>
</m:ResponseMessages>
</ExpandDLResponse>
</soap:Body>
</soap:Envelope>
Fehlerantwortelemente
Folgende Elemente werden in der Fehlerantwort verwendet:
Weitere Optionen für die Antwortmeldung des ExpandDL-Vorgangs finden Sie in der Schemahierarchie. Beginnen Sie mit dem ExpandDLResponse-Element .
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für