Exchange 2007 Provider::GetSMTPDomain

This procedure returns a collection of the AcceptedDomains.

Arguments

Remarks

Rollback Method: Not implemented

Sample Code

Example XML Request

<request> 
  <data> 
    <!--The domain controller to use for Active Directory actions.--> 
    <preferredDomainController>AD01.Fabrikam.Com</preferredDomainController> 
    <!--Specifies the accepted domain to retrieve.--> 
    <identity>AlpineSkiHouse.com</identity> 
  </data> 
  <procedure> 
    <execute namespace="Exchange 2007 Provider" procedure="GetSMTPDomain" impersonate="1"> 
      <before source="data" sourcePath="preferredDomainController" destination="executeData" mode="move" /> 
      <before source="data" sourcePath="identity" destination="executeData" mode="move" /> 
      <after source="executeData" destination="data" mode="merge" /> 
    </execute> 
  </procedure> 
</request>

Example XML Response

<response> 
  <data> 
    <!--Collection of Accepted Domains.--> 
    <acceptedDomains> 
      <!--Details of an Accepted Domain--> 
      <acceptedDomain> 
        <!--This parameter specifies the SMTP domain to be established as an accepted domain.  Wildcard character can be used to specify all subdomains of a given domain, as shown in the following example:   *.contoso.com.   However, wildcard characters cannot be embed, as shown in the following example:   domain.*.contoso.com.   The domain name string may not contain more than 256 characters.--> 
        <domainName>AlpineSkiHouse.com</domainName> 
        <!--Specifies the type of accepted domain to be configured.  In an authoritative domain, messages are delivered to a recipient that has a domain account in your Exchange organization. In an internal relay domain, messages are relayed to a server that is outside your Exchange organization, but still under the authority of your company or IT department. Use the internal relay domain if you want to treat the messages to this domain as internal messages. In an external relay domain, messages are relayed to an e-mail server, outside your organization, which you do not control.  The default value is Authoritative.--> 
        <domainType>Authoritative</domainType> 
        <!--Indicates whether AddressBook is enabled.--> 
        <addressBookEnabled>true</addressBookEnabled> 
        <!--Is default domain.--> 
        <default>false</default> 
        <!--Admin display name--> 
        <adminDisplayName>admin</adminDisplayName> 
        <!--Exchange Version.--> 
        <exchangeVersion>0.1 (8.0.535.0)</exchangeVersion> 
        <!--Name of the AcceptedDomain.--> 
        <name>AlpineSkiHouse.com</name> 
        <!--Distinguished Name of the AcceptedDomain.--> 
        <distinguishedName>CN=AlpineSkiHouse.com,CN=Accepted Domains,CN=Transport Settings,CN=Fabrikam,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=fabrikam,DC=com</distinguishedName> 
        <!--The Active Directory Object ID or a string that represents the GUID, distinguished name, domain or account, user principal name (UPN), legacy Exchange distinguished name, Simple Mail Transfer Protocol (SMTP) address, or alias.--> 
        <identity>AlpineSkiHouse.com</identity> 
        <!--GUID of the AcceptedDomain.--> 
        <guid>5a5f7a3a-d656-4ddc-b6cf-a28c3d40013a</guid> 
        <!--AD Object Category--> 
        <objectCategory>fabrikam.com/Configuration/Schema/ms-Exch-Accepted-Domain</objectCategory> 
        <!--ObjectClass values.--> 
        <objectClass> 
          <!--ObjectClass values.--> 
          <value>top</value> 
        </objectClass> 
        <!--When the object was changed.--> 
        <whenChanged>11/8/2006 10:51:39 AM</whenChanged> 
        <!--When the object was created.--> 
        <whenCreated>11/8/2006 10:51:39 AM</whenCreated> 
        <!--Originating Server--> 
        <originatingServer>AD01.fabrikam.com</originatingServer> 
        <!--ADPresentationObject is valid--> 
        <isValid>true</isValid> 
      </acceptedDomain> 
    </acceptedDomains> 
  </data> 
</response>

Applies To

Exchange 2007 Provider Namespace for:

• Hosted Messaging and Collaboration version 4.5

• Hosted Messaging and Collaboration version 4.0

See also

Tasks

Hosted Email 2007::CreateSMTPDomain
Hosted Email 2007::CreateConsumerVanityDomain
Hosted Email 2007::GetOrganizationDomains