New-SendConnector

  • [アーティクル]

 

適用先: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

トピックの最終更新日: 2007-09-05

ハブ トランスポート サーバーの役割またはエッジ トランスポート サーバーの役割がインストールされているコンピュータで新しい送信コネクタを作成するには、New-SendConnector コマンドレットを使用します。

構文

New-SendConnector -Name <String> -AddressSpaces <MultiValuedProperty> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

New-SendConnector -Name <String> [-AuthenticationCredential <PSCredential>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-ConnectionInactivityTimeOut <EnhancedTimeSpan>] [-Custom <SwitchParameter>] [-DNSRoutingEnabled <$true | $false>] [-DomainController <Fqdn>] [-DomainSecureEnabled <$true | $false>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-ForceHELO <$true | $false>] [-Fqdn <Fqdn>] [-IgnoreSTARTTLS <$true | $false>] [-Internal <SwitchParameter>] [-Internet <SwitchParameter>] [-LinkedReceiveConnector <ReceiveConnectorIdParameter>] [-MaxMessageSize <Unlimited>] [-Partner <SwitchParameter>] [-Port <Int32>] [-ProtocolLoggingLevel <None | Verbose>] [-RequireTLS <$true | $false>] [-SmartHostAuthMechanism <None | BasicAuth | BasicAuthRequireTLS | ExchangeServer | ExternalAuthoritative>] [-SmartHosts <MultiValuedProperty>] [-SourceIPAddress <IPAddress>] [-SourceTransportServers <MultiValuedProperty>] [-TemplateInstance <PSObject>] [-Usage <Custom | Internal | Internet | Partner>] [-UseExternalDNSServersEnabled <$true | $false>] [-WhatIf [<SwitchParameter>]]

解説

このコマンドレットでは、新しい送信コネクタを作成します。新しい送信コネクタの必須パラメータの入力を求めるメッセージを表示するには、「New-SendConnector」と入力します。このタスクを完了すると、送信コネクタが作成されます。

New-SendConnector コマンドレットを実行するには、使用するアカウントに Exchange サーバー管理者の役割、および対象サーバーのローカルの Administrators グループが委任されている必要があります。

エッジ トランスポート サーバーの役割がインストールされているコンピュータで New-SendConnector コマンドレットを実行するには、そのコンピュータのローカルの Administrators グループのメンバであるアカウントを使用してログオンする必要があります。

Microsoft Exchange Server 2007 を管理するために必要なアクセス許可、役割の委任、および権限の詳細については、「アクセス許可に関する考慮事項」を参照してください。

パラメータ

パラメータ 必須かどうか 種類 説明

AddressSpaces

必須

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータは、このコネクタが受信コネクタに関連付けられていない場合に必要です。関連付けられている受信コネクタが LinkedReceiveConnector パラメータを使用して指定されている場合、AddressSpaces パラメータの値は $null である必要があります。それ以外の場合は、AddressSpaces パラメータには、送信コネクタによるメッセージの送信先となるドメイン名を指定します。各アドレス スペースを入力するための完全な構文は以下のとおりです。<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • AddressSpaceType   エッジ トランスポート サーバーでは、アドレス スペースの種類は SMTP になっている必要があります。ハブ トランスポート サーバーでは、アドレス スペースの種類は SMTP、X400、またはその他のテキスト文字列です。アドレス スペースの種類を省略すると、種類は SMTP アドレス スペースと見なされます。
  • AddressSpace   SMTP アドレス スペースの種類には、RFC 1035 準拠のアドレス スペースを入力する必要があります。たとえば、*、*.com および *.contoso.com は使用できますが、*contoso.com は使用できません。X.400 アドレス スペースの種類には、o=MySite;p=MyOrg;a=adatum;c=us などの RFC 1685 準拠のアドレス スペースを入力する必要があります。その他のアドレスの種類の値には、アドレス スペースに任意のテキストを入力できます。
  • AddressSpaceCost    コストの有効な入力の範囲は 1 ～ 100 です。低いコストは、より良いルートを示します。このパラメータは省略可能です。アドレス スペースのコストを省略すると、コストとして 1 が使用されます。セミコロン (;) を含む SMTP 以外のアドレス スペースを入力する場合は、アドレス スペースのコストを指定する必要があります。

アドレス スペースの種類またはアドレス スペースのコストを指定する場合、アドレス スペースを二重引用符 (") で囲む必要があります。たとえば、次のアドレス スペース エントリは同等です。

  • "SMTP:contoso.com;1"
  • "contoso.com;1"
  • "SMTP:contoso.com"
  • contoso.com

複数のアドレス スペースを指定するには、アドレス スペースをコンマで区切ります。たとえば、"contoso.com,fabrikam.com" のようにします。アドレス スペースの種類またはアドレス スペースのコストを指定する場合、アドレス スペースを二重引用符 ( " ) で囲む必要があります。たとえば、"contoso.com;2","fabrikam.com;3" のように指定します。

ハブ トランスポート サーバーに構成されている送信コネクタに SMTP 以外のアドレス スペースの種類を指定する場合、送信コネクタで次の設定を行う必要があります。

  • SmartHosts パラメータの値を指定することで、スマート ホストを使用して電子メールをルーティングします。
  • $False に DNSRoutingEnabled パラメータを設定します。
note注 :
ハブ トランスポート サーバー上の送信コネクタで SMTP 以外のアドレス スペースを構成できますが、送信コネクタはトランスポート メカニズムとして SMTP を使用して他のメッセージング サーバーにメッセージを送信します。ハブ トランスポート サーバーの外部コネクタは、SMTP をプライマリ トランスポート メカニズムとして使用しない、サード パーティの FAX ゲートウェイ サーバーなどのローカルのメッセージング サーバーにメッセージを送信するために使用されます。詳細については、「外部コネクタ」を参照してください。

Name

必須

System.String

このパラメータには、管理者が設定したコネクタの名前を指定します。名前にスペースが含まれる場合は、Name パラメータを二重引用符で囲む必要があります。たとえば、「"New Send Connector"」と入力します。 "New Send Connector".

AuthenticationCredential

省略可能

System.Management.Automation.PSCredential

このパラメータには、資格情報オブジェクトの作成および指定が必要です。この資格情報オブジェクトは Get-Credential コマンドレットを使用して作成されます。Get-Credential コマンドレットの詳細については、Exchange 管理シェルで「Get-Help Get-Credential」と入力してください。

Comment

省略可能

System.String

Comment パラメータは、"this is an admin note" のように二重引用符で囲む必要があります。 "this is an admin note".

Confirm

省略可能

System.Management.Automation.SwitchParameter

Confirm パラメータを指定すると、コマンドの処理が一時停止します。処理を続行するには、コマンドの処理内容を確認する必要があります。Confirm パラメータで値を指定する必要はありません。

ConnectionInactivityTimeOut

省略可能

Microsoft.Exchange.Data.EnhancedTimeSpan

このパラメータには、アイドル状態の接続を開いておく最長時間を指定します。既定値は 10 分です。値を指定するには、dd.hh:mm:ss の形式で期間として入力します。d = 日、h = 時間、m = 分、s = 秒です。このパラメータの有効な入力の範囲は、00:00:01 ～ 1.00:00:00 です。

Custom

省略可能

System.Management.Automation.SwitchParameter

このパラメータは、使用法の種類として Custom を指定します。使用法の種類によって、送信コネクタに割り当てられるアクセス許可と認証方式が決定されます。Custom パラメータを使用する場合、次のパラメータは使用できません。

  • Internal
  • Internet
  • Partner
  • Usage

送信コネクタの使用法の種類、アクセス許可、および認証方法の詳細については、「送信コネクタ」を参照してください。

DNSRoutingEnabled

省略可能

System.Boolean

DnsRoutingEnabled パラメータに対して有効な値は、$True または $False です。既定値は $True です。SmartHosts パラメータを指定する場合、DnsRoutingEnabled パラメータは同じコマンド ラインで $False である必要があります。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、コマンドに DomainController パラメータを含めます。DomainController パラメータは、エッジ トランスポート サーバーの役割を実行するコンピュータではサポートされません。エッジ トランスポート サーバーの役割は、ローカルの ADAM インスタンスに対してのみ読み取りと書き込みを行います。

DomainSecureEnabled

省略可能

System.Boolean

このパラメータは、この送信コネクタのサービスを利用するドメインに対して、トランスポート層セキュリティ (TLS) の相互認証を有効にするプロセスの一部です。相互 TLS 認証は、以下の条件が満たされている場合にのみ正しく機能します。

  • DomainSecureEnabled パラメータの値が $True に設定されている。
  • DNSRoutingEnabled パラメータの値が $True に設定されている。
  • IgnoreStartTLS パラメータの値が $False に設定されている。

ワイルドカード文字 (*) は、相互 TLS 認証用に構成されているドメインではサポートされません。また、対応する受信コネクタと、Get-TransportConfig コマンドレットの TLSReceiveDomainSecureList パラメータの値に同じドメインが定義されている必要があります。

以下の種類の送信コネクタの場合、DomainSecureEnabled の既定値は $False です。

  • ハブ トランスポート サーバーで定義されるすべての送信コネクタ
  • エッジ トランスポート サーバーで定義される、ユーザー作成の送信コネクタ

以下の種類の送信コネクタの場合、DomainSecureEnabled の既定値は $True です。

  • エッジ トランスポート サーバーで定義される、既定の送信コネクタ

Enabled

省略可能

System.Boolean

このパラメータの有効な値は、$True または $False です。既定値は $True です。コネクタで電子メール メッセージを処理する機能を有効または無効にするには、Enabled パラメータを使用します。

Force

省略可能

System.Management.Automation.SwitchParameter

このパラメータを指定すると、特定の構成を変更しているときに表示される警告または確認のメッセージが表示されなくなります。

ForceHELO

省略可能

System.Boolean

このパラメータの有効な値は、$True または $False です。既定値は $False です。既定では、EHLO が使用されます。このパラメータが $True に設定されている場合、EHLO は送信されず、HELO が送信されます。

Fqdn

省略可能

Microsoft.Exchange.Data.Fqdn

このパラメータには、送信コネクタを使用して送信メッセージを受信する、接続済みメッセージング サーバーの送信元サーバーとして使用される FQDN を指定します。このパラメータの値は、以下の例に示すように送信元サーバー名が必要な場合に常に接続済みメッセージング サーバーで表示されます。

  • 送信コネクタが次ホップのメッセージング サーバーと通信する場合の EHLO/HELO コマンド内
  • ハブ トランスポート サーバーまたはエッジ トランスポート サーバーからのメッセージの送信後、次ホップのメッセージング サーバーによりメッセージに追加される、メッセージの最新の Received: ヘッダー フィールド内
  • TLS 認証中

Fqdn パラメータの既定値は $Null です。つまり、FQDN の実際の既定値は、その送信コネクタを含むハブ トランスポート サーバーまたはエッジ トランスポート サーバーの FQDN です。

note注 :
メールボックス サーバーの役割もインストールされているハブ トランスポート サーバー上で送信コネクタを構成する場合、Fqdn パラメータに指定する値は使用されません。代わりに、Get-ExchangeServer コマンドレットを使用することで表示されるサーバーの FQDN が常に使用されます。
ハブ トランスポート サーバーおよびメールボックス サーバーの両方の役割がインストールされているサーバーの場合、送信メッセージの Received: ヘッダーからサーバー名を削除する唯一の方法は、Remove-ADPermission コマンドレットを使用して、該当コネクタを使用するセキュリティ プリンシパルから Ms-Exch-Send-Headers-Routing アクセス許可を削除することです。この操作により、ハブ トランスポート サーバーからメッセージが送信されるときに、メッセージからすべての Received: ヘッダーが削除されます。Received: ヘッダーは最大ホップ数の計算に使用されるため、内部メッセージの Received: ヘッダーを削除することはお勧めしません。Remove-ADPermission コマンドレットおよび Get-ExchangeServer コマンドレットの詳細については、以下のトピックを参照してください。
• Remove-ADPermission
• Get-ExchangeServer

IgnoreSTARTTLS

省略可能

System.Boolean

このパラメータには、リモートの送信側サーバーによって指定される StartTLS オプションを無視するかどうかを指定します。このパラメータは、リモート ドメインで使用されます。RequireTLS パラメータが $True に設定されている場合は、このパラメータを $False に設定する必要があります。このパラメータの有効な値は、$True と $False です。

Internal

省略可能

System.Management.Automation.SwitchParameter

このパラメータは、使用法の種類として Internal を指定します。使用法の種類によって、送信コネクタに割り当てられるアクセス許可と認証方式が決定されます。Internal パラメータを使用する場合、次のパラメータは使用できません。

  • Custom
  • Internet
  • Partner
  • Usage

送信コネクタの使用法の種類、アクセス許可、および認証方法の詳細については、「送信コネクタ」を参照してください。

Internet

省略可能

System.Management.Automation.SwitchParameter

このパラメータは、使用法の種類として Internet を指定します。使用法の種類によって、送信コネクタに割り当てられるアクセス許可と認証方式が決定されます。Internet パラメータを使用する場合、次のパラメータは使用できません。

  • Custom
  • Internal
  • Partner
  • Usage

送信コネクタの使用法の種類、アクセス許可、および認証方法の詳細については、「送信コネクタ」を参照してください。

IsScopedConnector

省略可能

System.Boolean

このパラメータは、他のハブ トランスポート サーバーがコネクタを使用できるかどうかを制御します。このパラメータの値が $False である場合、Exchange 組織内のすべてのハブ トランスポート サーバーがこのコネクタを使用できます。このパラメータの値が $True である場合、コネクタは、同一の Active Directory サイト内のハブ トランスポート サーバーでのみ使用できます。既定値は $False です。

LinkedReceiveConnector

省略可能

Microsoft.Exchange.Configuration.Tasks.ReceiveConnectorIdParameter

このパラメータは、指定した受信コネクタによって受信されるすべてのメッセージを、この送信コネクタを通じて配信されるように強制します。LinkedReceivedConnector の値に次のいずれかの ID を使用して、受信コネクタを指定できます。

  • GUID
  • 識別名 (DN)
  • サーバー名\コネクタ名

New-SendConnector コマンドレットで LinkReceiveConnector パラメータを使用する場合、指定された値と共に次のパラメータも使用する必要があります。

  • DNSRoutingEnabled $False
  • MaxMessageSize unlimited
  • Smarthosts <スマート ホスト ID>
  • SmarthostAuthMechanism <認証機構>

LinkedReceiveConnector パラメータを使用するときは、AddressSpace パラメータを使用できません。

MaxMessageSize

省略可能

Microsoft.Exchange.Data.Unlimited

このパラメータには、コネクタを介して渡すことができるメッセージの最大サイズを指定します。既定値は 10MB です。値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

  • B (バイト)
  • KB (キロバイト)
  • MB (メガバイト)
  • GB (ギガバイト)

単位が付加されていない値は、バイトとして扱われます。バイト単位で入力された値は、直近の KB に切り上げられます。たとえば、1048575B は 1MB に切り上げられ、1048577 は 1025KB に切り上げられます。このパラメータの有効な入力の範囲は、0 ～ 2147483647 バイトです。送信コネクタのメッセージ サイズ制限を解除するには、値 unlimited を入力します。

Partner

省略可能

System.Management.Automation.SwitchParameter

このパラメータは、使用法の種類として Partner を指定します。使用法の種類によって、送信コネクタに割り当てられるアクセス許可と認証方式が決定されます。Partner パラメータを使用する場合、次のいずれのパラメータも使用できません。

  • Custom
  • Internal
  • Internet
  • Usage

送信コネクタの使用法の種類、アクセス許可、および認証方法の詳細については、「送信コネクタ」を参照してください。

Port

省略可能

System.Int32

このパラメータの有効な入力の範囲は、0 ～ 65535 の整数です。既定値は 25 です。SmartHosts パラメータに値を指定する場合、Port の値には、スマート ホスト転送に使用されるポート番号を指定します。多くの組織では、ポート番号は 25 に設定されています。

ProtocolLoggingLevel

省略可能

Microsoft.Exchange.Data.ProtocolLoggingLevel

このパラメータでは、指定した送信コネクタのプロトコル ログ出力を有効または無効にします。値 Verbose を指定すると、コネクタのプロトコル ログ出力が有効になります。値 None を指定すると、コネクタのプロトコル ログ出力が無効になります。ハブ トランスポート サーバーまたはエッジ トランスポート サーバーで構成されるすべての送信コネクタでは、送信コネクタのプロトコル ログの場所は Set-TransportServer コマンドレットの SendProtocolLogPath パラメータを使用して指定します。

RequireTLS

省略可能

System.Boolean

このパラメータには、このコネクタを介して送信されるすべてのメッセージが TLS を使用して送信される必要があるかどうかを指定します。既定値は $False です。

SmartHostAuthMechanism

省略可能

Microsoft.Exchange.Data.Directory.SystemConfiguration.SmtpSendConnectorConfig+AuthMechanisms

このパラメータは、リモート サーバーでの認証時に使用されます。このパラメータが使用されるのは、スマート ホストが構成され、DNSRoutingEnabled パラメータが $False に設定されている場合のみです。有効な値は、None、BasicAuth、BasicAuthRequireTLS、ExchangeServer、および ExternalAuthoritative です。すべての値は同時に使用することができません。BasicAuth または BasicAuthRequireTLS を選択する場合は、AuthenticationCredential パラメータを使用して認証資格情報を指定する必要があります。

SmartHosts

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータは、DnsRoutingEnabled パラメータを $False に設定する場合に必要であり、同じコマンド ラインで指定する必要があります。SmartHosts パラメータは 1 つ以上の FQDN (server.contoso.com など)、1 つ以上の IP アドレス、または FQDN と IP アドレスの組み合わせを取ります。各値はコンマで区切ります。IP アドレスの場合は、リテラルとして IP アドレスを入力します。たとえば、「10.10.1.1」と入力します。スマート ホストの識別情報としては、スマート ホスト サーバーの FQDN、MX (メール エクスチェンジャ) レコード、または A (アドレス) レコードを使用できます。FQDN をスマート ホストの識別情報として構成する場合は、送信コネクタの送信元サーバーがスマート ホスト サーバーの場所を特定するために DNS 名前解決を使用できる必要があります。

SourceIPAddress

省略可能

System.Net.IPAddress

このパラメータには、リモート メッセージング サーバーへの SMTP 接続のエンドポイントとして使用するローカル IP アドレスを指定します。既定の IP アドレスは 0.0.0.0 です。この値は、サーバーが利用可能な任意のローカル IP アドレスを使用するよう指定するものです。このパラメータは、エッジ トランスポート サーバー上で構成されている送信コネクタに対してのみ有効です。

SourceTransportServers

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータには、この送信コネクタを使用できるハブ トランスポート サーバーの名前を指定します。複数のハブ トランスポート サーバー名を指定する場合は、名前をコンマで区切ります。このパラメータは、エッジ トランスポート サーバー上で構成されている送信コネクタに対しては無効です。

TemplateInstance

省略可能

System.Management.Automation.PSObject

このパラメータに既存のオブジェクトを指定すると、コマンドはそのオブジェクトの構成を使用してローカル サーバーまたはターゲット サーバーにオブジェクトの同一コピーを作成します。

Usage

省略可能

Microsoft.Exchange.Management.SystemConfigurationTasks.NewSendConnector+UsageType

このパラメータを使用して、送信コネクタに割り当てられる既定のアクセス許可と認証方法を指定できます。このパラメータの有効な値は、Custom、Internal、Internet、または Partner です。Usage パラメータの値を指定しない場合、使用法の種類の既定値は Custom です。

Usage パラメータを使用する場合、次のパラメータは使用できません。

  • Custom
  • Internal
  • Internet
  • Partner

送信コネクタの使用法の種類、アクセス許可、および認証方法の詳細については、「送信コネクタ」を参照してください。

UseExternalDNSServersEnabled

省略可能

System.Boolean

このパラメータには、この送信コネクタが Set-TransportServer コマンドレットの ExternalDNSServers パラメータで指定される外部のドメイン ネーム システム (DNS) 一覧を使用するかどうかを指定します。既定値は $False です。このパラメータの有効な値は、$True と $False です。

WhatIf

省略可能

System.Management.Automation.SwitchParameter

WhatIf パラメータには、オブジェクトに対して行われる操作をシミュレートすることを指定します。WhatIf パラメータを使用することで、実際に変更を加えずに、発生する変更内容を表示することができます。WhatIf パラメータで値を指定する必要はありません。

入力の種類

戻り値の種類

エラー

エラー 説明

 

 

例

最初の例は、インターネット上で電子メール メッセージを送信する、新しい送信コネクタを作成するコマンドを示しています。次の例は、送信コネクタの作成に必要な最小限のパラメータを示しています。アドレス スペースは、Contoso.com ドメインおよび Microsoft.com ドメインのみへのメッセージの送信に制限されます。

2 番目の例は、Contoso.com に電子メール メッセージを送信する新しい送信コネクタを作成するコマンドを示しています。Contoso.com 電子メール サーバーでは、電子メール メッセージを送信するためにローカル Exchange 2007 サーバー認証が必要です。認証を使用するように送信コネクタを構成するには、まず Get-Credential コマンドを実行し、このコマンドを変数に設定する必要があります。Get-Credential コマンドを実行すると、Contoso.com の電子メール サーバーの認証時に使用されるアカウントのユーザー名とパスワードの入力が求められます。

2 番目の例では、Get-Credential コマンドレットが $CredentialObject 変数に設定されています。認証資格情報が $CredentialObject 変数に設定された後、New-SendConnector コマンドレットを使用して新しい送信コネクタを作成することができます。$CredentialObject 変数は AuthenticationCredential パラメータに渡されます。使用される資格情報の設定に加えて、SmartHostAuthMechanism パラメータを BasicAuth に設定し、指定した資格情報を使用して送信コネクタで Contoso.com 電子メール サーバーの認証を行うようにします。

New-SendConnector -Name Test -AddressSpaces contoso.com,microsoft.com
$CredentialObject = Get-Credential
New-SendConnector -Name "Secure E-Mail to Contoso.com" -AddressSpaces contoso.com -AuthenticationCredential $CredentialObject -SmartHostAuthMechanism BasicAuth

参照している情報が最新であることを確認したり、他の Exchange Server 2007 ドキュメントを見つけたりするには、Exchange Server TechCenter を参照してください。