Set-ForeignConnector

 

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

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

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

構文

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

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

解説

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

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

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

パラメータ

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

Identity

必須

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

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

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

AddressSpaces

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

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

  • AddressSpaceType   アドレス スペースの種類には、SMTPX400、またはその他のテキスト文字列を指定できます。アドレス スペースの種類を指定しない場合、アドレス スペースの種類は SMTP になります。
  • AddressSpace   アドレス スペースの種類が SMTP の場合、入力するアドレス スペースは RFC 1035 に準拠している必要があります。たとえば、**.com、および *.contoso.com は使用できますが、*contoso.com は使用できません。アドレス スペースの種類が X.400 の場合、入力するアドレスは RFC 1685 に準拠している必要があります (o=MySite;p=MyOrg;a=adatum;c=us など)。アドレス スペースの種類がそれ以外の場合、アドレス スペースには任意のテキストを入力できます。
  • 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" のように、アドレス スペースを二重引用符 ( " ) で囲む必要があります。

Comment

省略可能

System.String

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

Confirm

省略可能

System.Management.Automation.SwitchParameter

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

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 (テラバイト)

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

Enabled

省略可能

System.Boolean

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

Force

省略可能

System.Management.Automation.SwitchParameter

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

Instance

省略可能

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

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

IsScopedConnector

省略可能

System.Boolean

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

MaxMessageSize

省略可能

Microsoft.Exchange.Data.Unlimited

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

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

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

Name

省略可能

System.String

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

RelayDsnRequired

省略可能

System.Boolean

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

SourceTransportServers

省略可能

Microsoft.Exchange.Data.MultiValuedProperty

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

WhatIf

省略可能

System.Management.Automation.SwitchParameter

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

次のコードは、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 を参照してください。