Set-ForeignConnector

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

メールボックスサーバーのトランスポートサービス内の既存の外部コネクタを変更するには、Set-ForeignConnector コマンドレットを使用します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Set-ForeignConnector
   [-Identity] <ForeignConnectorIdParameter>
   [-AddressSpaces <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-DropDirectory <String>]
   [-DropDirectoryQuota <Unlimited>]
   [-Enabled <Boolean>]
   [-Force]
   [-IsScopedConnector <Boolean>]
   [-MaxMessageSize <Unlimited>]
   [-Name <String>]
   [-RelayDsnRequired <Boolean>]
   [-SourceTransportServers <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

説明

外部コネクタは、主要なトランスポートメカニズムとして SMTP を使用しないローカルのメッセージングサーバーに対してメッセージを送信するために、メールボックスサーバーのトランスポートサービスでドロップディレクトリを使用します。これらのメッセージングサーバーは、外部ゲートウェイサーバーとも呼ばれます。外部ゲートウェイサーバーの例としては、サードパーティの FAX ゲートウェイサーバーがあります。外部コネクタには、SMTP または SMTP 以外のアドレススペースを割り当てることができます。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MB

次の使用例は、FAX コネクタという名前の既存の外部コネクタに 10 MB のメッセージサイズ制限を構成します。

パラメーター

-AddressSpaces

AddressSpaces パラメーターは、外部コネクタがメッセージを送信するドメイン名を指定します。各アドレス空間を入力するための完全な構文は、です AddressSpaceType:AddressSpace;AddressSpaceCost。

AddressSpaceType:アドレススペースの種類は、SMTP、X400、またはその他のテキスト文字列です。アドレススペースの種類を指定しない場合、アドレススペースの種類は 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")。

既存のエントリに影響を与えずに 1 つ以上のアドレス空間値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Comment

Comment パラメーターで、オプションのコメントを指定します。スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

破壊的なコマンドレット (Remove-* コマンドレットなど) には、続行する前にコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (New-* コマンドレットや Set-* コマンドレットなど) には、一時停止が組み込まれています。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメインコントローラーを指定します。ドメインコントローラーは、完全修飾ドメイン名 (FQDN) で識別します。たとえば、dc01.contoso.com です。

DomainController パラメーターは、エッジトランスポートサーバーではサポートされません。エッジトランスポートサーバーは、Active Directory ライトウェイトディレクトリサービス (AD LDS) のローカルインスタンスを使用してデータの読み書きを行います。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DropDirectory

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

Set-TransportService コマンドレットの RootDropDirectoryPath パラメーター: このオプションは、メールボックスサーバー上に存在するすべての外部コネクタに使用されます。 RootDropDirectoryPath パラメーターの値は、リモートサーバーへのローカルパスまたは汎用名前付け規則 (UNC) パスです。
Set-ForeignConnector コマンドレットの DropDirectory パラメーター: この値は、サーバーに存在する外部コネクタごとに設定されます。

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

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

Drop ディレクトリは自動的に作成されません。そのため、各 Drop ディレクトリフォルダーを手動で作成する必要があります。

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

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DropDirectoryQuota

DropDirectoryQuota パラメーターは、Drop ディレクトリ内のすべてのメッセージファイルの最大サイズを指定します。指定した値に達すると、既存のメッセージが配信および削除されるまで、新しいメッセージファイルを Drop ディレクトリにコピーすることはできません。

値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

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

通常、単位なしの値はバイトとして扱われますが、小さい値は最も近いキロバイトの値に切り上げられます。

このパラメーターの有効な入力範囲は、1 バイトから2147483647 バイトです。無制限の値を入力した場合、メッセージサイズの制限は Drop ディレクトリに課されません。既定値は unlimited です。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Enabled パラメーターは、外部コネクタを有効にするかどうかを指定します。有効な値は、$True または $False です。既定値は $true です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Force

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

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

GUID
コネクタ名
ServerName\ConnectorName

Type:	ForeignConnectorIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IsScopedConnector

IsScopedConnector パラメーターは、その他のメールボックスサーバーに対するコネクタの可用性を指定します。このパラメーターの値を$falseすると、Exchange 組織内のすべてのメールボックスサーバーでコネクタを使用できます。このパラメーターの値が$trueされている場合、コネクタは、同じ Active Directory サイト内のメールボックスサーバーでのみ使用できます。既定値は $false です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxMessageSize

MaxMessageSize パラメーターは、この外部コネクタを通過できるメッセージの最大サイズを指定します。

値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

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

通常、単位なしの値はバイトとして扱われますが、小さい値は最も近いキロバイトの値に切り上げられます。

無制限の値を入力した場合、この外部コネクタにメッセージサイズの制限は適用されません。既定値は unlimited です。このパラメーターの有効な入力範囲は、0 から2147483647 KB です。 MaxMessageSize パラメーターの値を 0 に設定した場合は、外部コネクタを効果的に無効にします。ただし、Enabled 属性の値が$trueされたときに MaxMessageSize パラメーターの値を 0 に設定すると、イベントログエラーが生成されます。外部コネクタを無効にするには、Enabled パラメーターを使用することをお勧めします。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RelayDsnRequired

RelayDsnRequired パラメーターは、メッセージが Drop ディレクトリに書き込まれるときに、外部コネクタによってリレー配信状態通知 (DSN) が必要かどうかを指定します。このパラメーターの有効な入力値は、$trueまたは$falseです。既定値は $false です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceTransportServers

SourceTransportServers パラメーターでは、この外部コネクタを使用するメールボックスサーバーの名前を指定します。トランスポートサービスを実行している複数のメールボックスサーバーに 1 つの外部コネクタを配置すると、いずれかのサーバーが失敗した場合にフォールトトレランスと高可用性が提供されます。このパラメーターの既定値は、この外部コネクタが最初にインストールされたメールボックスサーバーの名前です。

複数の値を入力し、既存のエントリを上書きするには、次の構文を使用します。 Value1,Value2,...ValueN 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"

既存のエントリに影響を与えずに 1 つ以上の値を追加または削除するには、次の構文を使用します。 @{Add="Value1","Value2"...; Remove="Value3","Value4"...}

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。このスイッチで値を指定する必要はありません。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。