AddDistributionGroupToImList-Vorgang

  • Artikel

Hier finden Sie Informationen zum EWS-Vorgang AddDistributionGroupToImList .

Der Vorgang AddDistributionGroupToImList Exchange Web Services (EWS) fügt der Chatliste im einheitlichen Kontaktspeicher eine Verteilergruppe hinzu.

Dieser Vorgang wurde in Exchange Server 2013 eingeführt.

Verwenden des AddDistributionGroupToImList-Vorgangs

Der AddDistributionGroupToImList-Vorgang verwendet ein einzelnes Argument, das eine Verteilergruppe identifiziert, die der Chatliste hinzugefügt werden soll. Durch diesen Vorgang wird keine Verteilergruppe erstellt. die Verteilergruppe muss bereits erstellt werden.

Dieser Vorgang kann die SOAP-Header verwenden, die in der folgenden Tabelle aufgeführt sind.

Tabelle 1. SOAP-Header des AddDistributionGroupToImList-Vorgangs

Headername Element Beschreibung
Impersonation
ExchangeImpersonation
Identifiziert den Benutzer, für den die Clientanwendung einen Identitätswechsel durchführt. Dies gilt für eine Anforderung.
MailboxCulture
MailboxCulture
Identifiziert die Kultur, wie in RFC 3066 "Tags für die Identifizierung von Sprachen" definiert, die für den Zugriff auf das Postfach verwendet werden soll. Dies gilt für eine Anforderung.
RequestVersion
RequestServerVersion
Gibt die Schemaversion für die Vorgangsanforderung an. Dies gilt für eine Anforderung.
ServerVersion
ServerVersionInfo
Gibt die Version des Servers an, der auf die Anforderung geantwortet hat. Dies gilt für eine Antwort.

Beispiel für eine Anforderung des AddDistributionGroupToImList-Vorgangs

Das folgende Beispiel einer AddDistributionGroupToImList-Vorgangsanforderung zeigt, wie Sie der Chatliste eine Verteilergruppe hinzufügen.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
      <t:MailboxCulture>en-US</t:MailboxCulture>
   </soap:Header>
   <soap:Body >
      <m:AddDistributionGroupToImList>
         <m:SmtpAddress>distributionlist1@example.com</m:SmtpAddress>
      </m:AddDistributionGroupToImList>
   </soap:Body>
</soap:Envelope>

Der SOAP-Anforderungstext enthält die folgenden Elemente:

Erfolgreiche Antwort des AddDistributionGroupToImList-Vorgangs

Das folgende Beispiel zeigt eine erfolgreiche Antwort auf eine AddDistributionGroupToImList-Vorgangsanforderung .

Die erfolgreiche Antwort enthält den Anzeigenamen der Verteilergruppe, die Exchange-Speicherklasse für die Verteilergruppe und den EWS-Bezeichner der neuen Verteilergruppe.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
            xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
            xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
   <s:Header>
      <t:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="349" 
                           MinorBuildNumber="0" 
                           Version="Exchange2013"/>
   </s:Header>
   <s:Body>
      <m:AddDistributionGroupToImListResponse ResponseClass="Success">
         <m:ResponseCode>NoError</m:ResponseCode>
         <m:ImGroup>
            <t:DisplayName>distributionlist1@example.com</t:DisplayName>
            <t:GroupType>IPM.DistList.MOC.DG</t:GroupType>
            <t:ExchangeStoreId Id="AAMkAGQ1MjJjAA=" 
                             ChangeKey="EgAAAA=="/>
      </m:ImGroup>
      </m:AddDistributionGroupToImListResponse>
   </s:Body>
</s:Envelope>

Der SOAP-Antworttext enthält die folgenden Elemente:

AddDistributionGroupToImList-Vorgang ErrorInvalidImDistributionGroupSmtpAddress-Fehlerantwort

Das folgende Beispiel zeigt eine Fehlerantwort auf eine AddDistributionGroupToImList-Vorgangsanforderung . Die folgende Fehlerantwort tritt auf, wenn versucht wird, eine Verteilergruppe hinzuzufügen, die im Exchange-Speicher nicht vorhanden ist.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="349" 
                           MinorBuildNumber="0" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <AddDistributionGroupToImListResponse ResponseClass="Error" 
                                            xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified IM distribution group SMTP address is invalid.</MessageText>
         <ResponseCode>ErrorInvalidImDistributionGroupSmtpAddress</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </AddDistributionGroupToImListResponse>
   </s:Body>
</s:Envelope>

Der SOAP-Text der Fehlerantwort enthält die folgenden Elemente:

Siehe auch