ExpandDL 操作

[アーティクル]
02/12/2022

ExpandDL 操作は、配布リストの完全なメンバーシップを公開します。

ExpandDL Web メソッドの使用

ExpandDL 操作は、Exchange.asmx にある Web サービスを使用します。この Web サービスメソッドは、パブリック配布リストを展開する EmailAddress (NonEmptyStringType) 子要素、またはプライベート配布リストの展開用の ItemId 子要素のいずれかを含むメールボックス要素を受け入れる。

パブリック配布リストは、次のいずれかを使用して展開できます。

配布リストのエイリアス
簡易メール転送プロトコル (SMTP) アドレス
X400
X500
Exchangeレガシアドレス
配布リスト名
表示名

重要

表示名は一意ではありません。複数のアカウントで同じ表示名を共有できます。

解説

再帰的拡張はサポートされていません。 1 回の呼び出しで展開できる配布リストは 1 つのみです。複数の配布リストが条件に一致する場合、Web サービスはエラーを報告します。クライアントアプリケーションでは、あいまいな名前解決 (ANR) を使用してあいまいな配布リストを検索し、 ExpandDL 操作のパラメーターとして必要な配布リストの正しい電子メールアドレスを選択できます。詳細については、「 ResolveNames 操作」を参照してください。

パブリック配布リストは Active Directory にあります。メールが有効な配布グループまたは動的配布グループを指定できます。グループをアドレス一覧から非表示にし、各メンバーに空でない電子メールアドレスを設定する必要があります。配布リストのメンバーには、メールが有効なユーザーと連絡先、パブリックフォルダー、メールが有効な配布リストと動的グループを指定できます。

プライベート配布リストは、ユーザーのメールボックスの連絡先フォルダーにあります。プライベート配布リストには電子メールアドレスが含めないので、ストアアイテム識別子は ExpandDL 要求で使用されます。プライベート配布リストのメンバーには、Active Directory のメールが有効なユーザー、連絡先または配布リスト、ユーザーの連絡先フォルダーの連絡先またはプライベート配布リストを指定できます。

連絡先またはプライベート配布リストの場合、アイテム識別子は応答で返されます。これは、オブジェクトに関する情報を取得したり、プライベート配布リストのメンバーシップを拡張したりするために使用できます。

ExpandDL プライベート配布リスト要求の例

説明

ExpandDL 要求の次の例は、プライベート配布リストを展開する要求を形成する方法を示しています。

コード

<?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>

Comments

プライベート配布リストを展開するには、 Mailbox 要素に、ユーザーのメールボックス内のプライベート配布リストを識別する ItemId 要素が含まれる。

ExpandDL パブリック配布リスト要求の例

説明

ExpandDL 要求の次の例は、パブリック配布リストを展開する要求を形成する方法を示しています。この例では、表示名を使用して配布リストを展開します。

コード

<?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>

Comments

この要求に対する応答には、配布リスト内の各メールボックスを識別する Mailbox 要素が含まれます。配布リストが配布リスト内に含まれている場合は、埋め込み配布リストで別の配布リストの展開を実行する必要があります。配布リストにメンバーがない場合、または要求された配布リストが存在しない場合、 ResponseClass 属性には Success と等しい値が含まれる。

要求要素

要求では、次の要素が使用されます。

ExpandDL
メールボックス
EmailAddress (NonEmptyStringType) は、パブリック配布リストを識別するために使用されます。 ItemId 要素は、プライベート配布リストを識別するために使用されます。

注意

これらの要素を記述するスキーマは、クライアントアクセスサーバーの役割がインストールされている MicrosoftExchange Server 2007 を実行しているコンピューターの EWS 仮想ディレクトリにあります。

ExpandDL 応答の成功例

説明

ExpandDL 応答の次の例は、上記の要求に対する応答を示しています。配布リストの展開では、次の項目について説明します。

応答で返される配布リストのメンバーの数。
応答に配布リストのすべてのメンバーが含まれているかどうか。
メールボックスの名前。
メールボックスの電子メールアドレス。
メールボックスのルーティングの種類。
メールボックスの種類。

注意

配布リスト名は応答に含まれません。したがって、要求から名前を追跡する必要があります。

コード

<?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>

成功した応答要素

応答では、次の要素が使用されます。

ExpandDL 操作の応答メッセージのその他のオプションを見つけるには、スキーマ階層を確認します。 ExpandDLResponse 要素から開始します。

ExpandDL エラー応答

説明

次の例は、ExpandDL 要求に対するエラー応答を示しています。

コード

<?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>

エラー応答要素

エラー応答では、次の要素が使用されます。

ExpandDL 操作の応答メッセージのその他のオプションを見つけるには、スキーマ階層を確認します。 ExpandDLResponse 要素から開始します。

次の方法で共有

ExpandDL 操作

ExpandDL Web メソッドの使用

解説

ExpandDL プライベート配布リスト要求の例

説明

コード

Comments

ExpandDL パブリック配布リスト要求の例

説明

コード

Comments

要求要素

ExpandDL 応答の成功例

説明

コード

成功した応答要素

ExpandDL エラー応答

説明

コード

エラー応答要素

関連項目

その他のリソース