Exchange サーバーからドメイン設定を取得する

  • [アーティクル]

自動検出サービスを使用して Exchange サーバーからドメインの設定を取得する方法について説明します。

自動検出サービスを使用して、メール ドメインの構成情報を取得できます。 自動検出サービスは、アプリケーションが特定のドメインの正しいサービス エンドポイントに接続するためのプロセスを提供します。

自動検出サービスにアクセスするには、次の開発テクノロジのうちのいずれかを使用できます。

  • Exchange Web サービス (EWS) マネージ API

  • EWS

    EWS を使用する場合は、次の方法を使用してユーザー設定を取得できます。

    • SOAP ベースの自動検出サービス

    • XML (POX) 自動検出サービス

    • SOAP または XML の自動検出サービスから生成される、自動生成されたプロキシ

      これらの方法の詳細については、「Exchange の自動検出」をご覧ください。

EWS マネージ API は、ユーザー設定を取得するためのオブジェクト ベースのインターフェイスを提供します。 クライアント アプリケーションがマネージ コードを使用する場合は、EWS マネージ API を使用することをお勧めします。 EWS マネージ API インターフェイスは、標準的な自動生成された Web サービス プロキシよりも、単純なオブジェクト モデルに対してより最適化されています。

EWS を使用している場合は、POX の自動検出サービスよりも豊富な機能をサポートしている SOAP の自動検出サービスの使用をお勧めします。

自動検出サービスは、要求された構成設定のみを返します。 次の表に、自動検出サービスが返すことができるドメインの構成設定の一覧を示します。

表 1: ドメインの構成設定

構成設定 説明
ExternalEwsUrl
 EWS の外部 URL。
ExternalEwsVersion
 EWS URL をホストする Exchange Server のバージョン。

ドメインの設定を取得するための前提条件

ドメインの設定を取得するために自動検出サービスに接続するアプリケーションを作成する前に、次にアクセスできることを確認します。

注:

EWS マネージ API を使用する場合、状況によっては証明書の検証コールバックを提供する必要があります。 Visual Studio で作成されたものなど、いくつかの生成されたプロキシ ライブラリによる証明書の検証コールバックが必要になる場合もあります。 詳細については、「EWS マネージ API のサーバー証明書を検証する」をご覧ください。

ドメインの設定の取得に関する中心概念

自動検出を使用してドメインの設定を取得する前に、次の表に一覧表示されている概念を理解する必要があります。

概念 説明
Exchange の自動検出
自動検出サービスの動作方法の概要を示します。
自動検出を使用して接続ポイントを検索する
クライアント アプリケーションを適切なサービス エンドポイントにリダイレクトするために自動検出サービスによって使用されるプロセスについて説明します。

EWS マネージ API を使用する場合は、Microsoft.Exchange.WebServices.Data 名前空間の Microsoft.Exchange.WebServices.Data.ExchangeService クラスを使用して、EWS への接続を管理します。 このセクションのコード例では、コードで次の名前空間を参照することを前提としています。

  • System.Net

  • Microsoft.Exchange.WebServices.Data.ExchangeService

EWS マネージ API を使用して、ドメインの設定を取得する

EWS マネージ API を使用する場合は、次の例に示すように、Microsoft.Exchange.WebServices.Data.AutodiscoverService オブジェクトの Microsoft.Exchange.WebServices.Data.AutodiscoverSettings.GetUserSettings メソッドを使用して、ドメインの構成情報を取得する要求を生成することができます。 この例では、使用可能なドメインの設定の一部だけが要求され、要求された設定のみがサーバーから返されます。

AutodiscoverService autodiscoverService = new AutodiscoverService("domain.contoso.com");
autodiscoverService.Credentials = new NetworkCredential("User1", "password", "domain.contoso.com");
// Submit a request and get the settings. The response contains only the
// settings that are requested, if they exist.
GetDomainSettingsResponse domainresponse = autodiscoverService.GetDomainSettings(
    "domain",
    ExchangeVersion.Exchang2013,
    DomainSettingName.ExternalEwsUrl,
    DomainSettingName.ExternalEwsVersion);

返されたコレクションを解析して、各キー/値ペアにアクセスできます。 次の使用例は、返された各要素を解析し、各キー/値ペアの名前と値を表示する方法を示しています。

// Display each retrieved value. The settings are part of a key/value pair.
foreach (KeyValuePair<DomainSettingName, Object> domainsetting in domainresponse.Settings)
{
    Console.WriteLine(domainsetting.Key.ToString() + ": " + domainsetting.Value.ToString());
}

または、特定の設定の値を取得できます。 次の例では、ExternalEwsUrl の設定が表示されます。

// Display a specific setting, such as ExternalEwsUrl.
Console.WriteLine(domainresponse.Settings[DomainSettingName.ExternalEwsUrl]);

EWS SOAP 自動検出を使用してユーザー設定を取得する

次の例では、自動検出サービスから両方のドメインの設定を取得する SOAP XML 要求を示しています。

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover" 
        xmlns:wsa="http://www.w3.org/2005/08/addressing" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <a:RequestedServerVersion>Exchange2013</a:RequestedServerVersion>
    <wsa:Action>https://schemas.microsoft.com/exchange/2010/Autodiscover/Autodiscover/GetDomainSettings</wsa:Action>
    <wsa:To>https://autodiscover.exchange.microsoft.com/autodiscover/autodiscover.svc</wsa:To>
  </soap:Header>
  <soap:Body>
    <a:GetDomainSettingsRequestMessage xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover">
      <a:Request>
        <a:Domains>
          <a:Domain>domain</a:Domain>
        </a:Domains>
        <a:RequestedSettings>
          <a:Setting>ExternalEwsUrl</a:Setting>
          <a:Setting>ExternalEwsVersion</a:Setting>
        </a:RequestedSettings>
        <a:RequestedVersion>Exchange2013</a:RequestedVersion>
      </a:Request>
    </a:GetDomainSettingsRequestMessage>
  </soap:Body>
</soap:Envelope>

次の例では、サーバーがクライアントからの要求を解析した後に返す XML 応答を示します。

<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/" 
        xmlns:a="http://www.w3.org/2005/08/addressing">
  <s:Header>
    <a:Action s:mustUnderstand="1">https://schemas.microsoft.com/exchange/2010/
          Autodiscover/Autodiscover/GetDomainSettingsResponse</a:Action>
    <h:ServerVersionInfo xmlns:h="https://schemas.microsoft.com/exchange/2010/Autodiscover" 
          xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <h:MajorVersion>15</h:MajorVersion>
      <h:MinorVersion>0</h:MinorVersion>
      <h:MajorBuildNumber>160</h:MajorBuildNumber>
      <h:MinorBuildNumber>4</h:MinorBuildNumber>
      <h:Version>Exchange2013</h:Version>
    </h:ServerVersionInfo>
  </s:Header>
  <s:Body>
    <GetDomainSettingsResponseMessage xmlns="https://schemas.microsoft.com/exchange/2010/Autodiscover">
      <Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <ErrorCode>NoError</ErrorCode>
        <ErrorMessage />
        <DomainResponses>
          <DomainResponse>
            <ErrorCode>NoError</ErrorCode>
            <ErrorMessage>No error.</ErrorMessage>
            <DomainSettingErrors />
            <DomainSettings>
              <DomainSetting i:type="DomainStringSetting">
                <Name>ExternalEwsUrl</Name>
                <Value>https://failover.exchange.microsoft.com/ews/exchange.asmx</Value>
              </DomainSetting>
              <DomainSetting i:type="DomainStringSetting">
                <Name>ExternalEwsVersion</Name>
                <Value>15.00.0085.000</Value>
              </DomainSetting>
            </DomainSettings>
            <RedirectTarget i:nil="true" />
          </DomainResponse>
        </DomainResponses>
      </Response>
    </GetDomainSettingsResponseMessage>
  </s:Body>
</s:Envelope>

次の手順

ドメインの設定は、EWS に接続するときにクライアントが必要とする基本的な情報を提供します。 この情報を使用して EWS に接続するか、またはサーバーからメール アカウントの追加の構成設定を取得することができます。 詳細については、以下の記事をご覧ください。

関連項目