Set-ForeignConnector (RTM)

  • [アーティクル]

 

適用先: Exchange Server 2007

トピックの最終更新日: 2007-06-11

ハブ トランスポート サーバーの役割がインストールされ、Microsoft Exchange Server 2007 を実行しているコンピュータで、既存の外部コネクタを変更するには、Set-ForeignConnector コマンドレットを使用します。外部コネクタは、ハブ トランスポート サーバーのドロップ ディレクトリを使用して、主要なトランスポート メカニズムとして SMTP (簡易メール転送プロトコル) を使用しないローカル メッセージング サーバーにメッセージを送信します。これらのメッセージング サーバーは、外部ゲートウェイ サーバーとも呼ばれます。外部ゲートウェイ サーバーの例としては、サード パーティの FAX ゲートウェイ サーバーがあります。外部コネクタには、SMTP または SMTP 以外のアドレス スペースを割り当てることができます。

構文

Set-ForeignConnector -Identity <ForeignConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Instance <ForeignConnector>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]

解説

Set-ForeignConnector コマンドレットは、既存の外部コネクタを変更します。Set-ForeignConnector コマンドレットを使用するときにプロパティの変更を指定すると、既存のプロパティ値が上書きされます。

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

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

パラメータ

パラメータ 必須 種類 説明

Identity

必須

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

このパラメータには、変更する外部コネクタを指定します。Identity パラメータには、外部コネクタ オブジェクトを表す次のいずれかの値を指定できます。

  • GUID
  • コネクタ名
  • サーバー名\コネクタ名

AddressSpaces

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータには、外部コネクタによるメッセージの送信先となるドメイン名を指定します。複数のアドレス スペースを指定するには、アドレス スペースをコンマで区切ります。各アドレス スペースを入力するための完全な構文は以下のとおりです。

<ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>

  • ConnectorScope   Local の値を指定すると、New-SendConnector コマンドレットが実行されている元のハブ トランスポート サーバーと同じ Active Directory サイトにある別のハブ トランスポート サーバーのみが、このコネクタを使用できます。ConnectorScope 修飾子を省略すると、Exchange 2007 組織全体に存在するすべてのハブ トランスポート サーバーがこのコネクタを使用できます。
  • AddressSpaceType   SMTP アドレス スペースの場合、この値は SMTP である必要があります。SMTP 以外のアドレス スペースについては、この値は "Lotus Notes" のようなわかりやすい任意の文字列とすることができます。
  • AddressSpace   SMTP アドレス スペースの場合、RFC 1035 に定義されているドメイン ネーム システム (DNS) のワイルドカード文字 (*) ("*"、"*.com."、*.contoso.com" など) を使用できます。SMTP 以外のアドレス スペースでは、ワイルドカード文字 (*) およびその他の文字 ("*contoso.com"、"@contoso" など) を使用できます。
  • AddressSpaceCost   コストの有効な入力の範囲は 1 ～ 100 です。低いコストは、より良いルートを示します。このパラメータは省略可能です。完全な構文を使用してアドレス スペースを入力するときに AddressSpaceCost 修飾子を省略すると、コストとして 1 が使用されます。

AddressSpaces パラメータに複雑な構文を使用する必要があるのは、次の状況の場合のみです。

  • Local 修飾子を持つスコープが限定されたコネクタ
  • SMTP 以外のアドレス スペース
  • コストが 1 でない SMTP アドレス スペース

AddressSpaces パラメータの値として、1 つのドメイン名またはコンマ区切りのドメイン名リストを入力した場合は、各ドメイン名にはアドレス スペースの種類として SMTP、コストとして 1 が使用されます。

Comment

省略可能

System.String

このパラメータには、外部コネクタの省略可能なコメントを指定します。Comment パラメータは、"this is an admin note" のように二重引用符で囲む必要があります。

DomainController

省略可能

Microsoft.Exchange.Data.Fqdn

この構成の変更を Active Directory ディレクトリ サービスに書き込むドメイン コントローラの完全修飾ドメイン名 (FQDN) を指定するには、DomainController パラメータを含めます。

DropDirectory

省略可能

System.String

このパラメータには、この外部コネクタで使用するドロップ ディレクトリの名前を指定します。この外部コネクタで定義されているアドレス スペースに送信されるすべての送信メッセージは、指定されたドロップ ディレクトリに保存されます。各外部コネクタのドロップ ディレクトリの場所は、次の 2 つの項目によって制御されます。

  • Set-TransportServer コマンドレットの RootDropDirectoryPath パラメータ   このオプションは、ハブ トランスポート サーバー上に存在するすべての外部コネクタに対して使用します。RootDropDirectoryPath パラメータの値には、ローカル パス、またはリモート サーバーへの汎用名前付け規則 (UNC) パスを指定できます。
  • Set-ForeignConnector コマンドレットの DropDirectory パラメータ   この値は、ハブ トランスポート サーバー上に存在する各外部コネクタに対して設定します。

既定では、RootDropDirectoryPath パラメータは空白です。これは、RootDropDirectoryPath の値が Exchange 2007 インストール フォルダであることを示します。既定の Exchange 2007 インストール フォルダは、C:\Program Files\Microsoft\Exchange Server\ です。既定では、DropDirectory パラメータの値は外部コネクタの名前です。

DropDirectory パラメータの値に絶対パスの情報が含まれていない場合、ドロップ ディレクトリの場所は DropDirectory パラメータと RootDropDirectoryPath パラメータの組み合わせによって定義されます。DropDirectory パラメータの値に絶対パスの情報が含まれている場合は、RootDropDirectoryPath の値を指定してはいけません。ドロップ ディレクトリの場所は、DropDirectory パラメータのみによって定義されます。

ドロップ ディレクトリは自動的には作成されません。したがって、ドロップ ディレクトリ フォルダは 1 つ 1 つ手動で作成する必要があります。

ドロップ ディレクトリには、次のアクセス許可が割り当てられている必要があります。

  • ネットワーク サービス :フル コントロール
  • システム :フル コントロール
  • 管理者 :フル コントロール

DropDirectoryQuota

省略可能

Microsoft.Exchange.Data.Unlimited

このパラメータには、ドロップ ディレクトリのすべてのメッセージ ファイルの最大サイズを指定します。指定した値に到達すると、既存のメッセージが配信されて削除されるまで、新しいメッセージ ファイルをドロップ ディレクトリにコピーできません。DropDirectoryQuota パラメータに値を入力するときは、以下の単位のいずれかを付加した形式で記述します。

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

単位が付加されていない値は、バイトとして扱われます。このパラメータの有効な入力の範囲は、1 ～ 2147483647 バイトです。値として unlimited を入力すると、ドロップ ディレクトリにメッセージ サイズの制限が適用されません。既定値は unlimited です。

Enabled

省略可能

System.Boolean

このパラメータは、外部コネクタを有効または無効にします。有効な入力値は、$True または $False です。既定値は $True です。

Instance

省略可能

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

Instance パラメータを使用すると、オブジェクト全体をコマンドに渡して処理することができます。オブジェクト全体をコマンドに渡す必要があるスクリプトで主に使用されます。

MaxMessageSize

省略可能

Microsoft.Exchange.Data.Unlimited

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

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

単位が付加されていない値は、キロバイトとして扱われます。値として unlimited を入力すると、この外部コネクタにメッセージ サイズの制限が適用されません。既定値は unlimited です。このパラメータの有効な入力の範囲は、0 ～ 2147483647 KB です。MaxMessageSize パラメータの値を 0 に設定すると、外部コネクタは無効になります。ただし、Enabled 属性の値が $True のときに MaxMessageSize パラメータの値を 0 に設定すると、イベント ログのエラーが生成されます。外部コネクタを無効にするには、Enabled パラメータを使用する方法をお勧めします。

Name

省略可能

System.String

このパラメータには、外部コネクタのわかりやすい名前を指定します。

RelayDsnRequired

省略可能

System.Boolean

このパラメータには、メッセージをドロップ ディレクトリに書き込むときに、外部コネクタで中継の配信状態通知 (DSN) が要求されるかどうかを指定します。このパラメータの有効な入力値は、$True または $False です。既定値は $False です。

SourceTransportServers

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

このパラメータには、この外部コネクタを使用するハブ トランスポート サーバーの名前を指定します。複数のハブ トランスポート サーバーを指定するには、サーバー名をコンマで区切ります。1 つの外部コネクタが複数のハブ トランスポート サーバーをホーム サーバーとすることによって、いずれかのハブ トランスポート サーバーで障害が発生した場合のフォールト トレランスと高可用性を実現することができます。このパラメータの既定値は、外部コネクタが最初にインストールされたハブ トランスポート サーバーの名前です。

例

次のコードは、Set-ForeignConnector コマンドレットを使用する 2 つの使用例を示しています。

最初の例は、"Contoso Foreign Connector" という名前の既存の外部コネクタを変更する Set-ForeignConnector コマンドを示しています。このコマンドは、MaxMessageSize パラメータを 10 MB に設定します。

2 つ目の例は、"Contoso Foreign Connector" という名前の既存の外部コネクタがサービスを提供するアドレス スペースを変更する Set-ForeignConnector コマンドを示しています。アドレス スペースの詳細は、以下のとおりです。

  • 最初のアドレス スペース :
    • アドレス スペースの種類 : SMTP
    • アドレス スペース : "*.contoso.com"
    • アドレス スペースのコスト : 1
  • 2 つ目のアドレス スペース :
    • アドレス スペースの種類 : ロータス ノーツ
    • アドレス スペース : "*@domino"
    • アドレス スペースのコスト : 55
Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB
Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55"

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