Set-ForeignConnector
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
メールボックス サーバーのトランスポート サービス内の既存の外部コネクタを変更するには、Set-ForeignConnector コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
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 を使用しないローカルのメッセージング サーバーに対してメッセージを送信するために、メールボックス サーバーのトランスポート サービスでドロップ ディレクトリを使用します。 これらのメッセージング サーバーは、外部ゲートウェイ サーバーとも呼ばれます。 Microsoft 以外の FAX ゲートウェイ サーバーは、外部ゲートウェイ サーバーの例です。 外部コネクタには、SMTP または SMTP 以外のアドレス スペースを割り当てることができます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-ForeignConnector "Fax Connector" -MaxMessageSize 10MB
次の使用例は、FAX コネクタという名前の既存の外部コネクタに 10 MB のメッセージ サイズ制限を構成します。
パラメーター
-AddressSpaces
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
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"...}。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Comment
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DropDirectory
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
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 ディレクトリには、次のアクセス許可が割り当てられている必要があります。
- ネットワーク サービス :フル コントロール
- システム :フル コントロール
- 管理者 :フル コントロール
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DropDirectoryQuota
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DropDirectoryQuota パラメーターは、Drop ディレクトリ内のすべてのメッセージ ファイルの最大サイズを指定します。 指定した値に達すると、既存のメッセージが配信および削除されるまで、新しいメッセージ ファイルを Drop ディレクトリにコピーすることはできません。
値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。
- B (バイト)
- KB (キロバイト)
- MB (メガバイト)
- GB (ギガバイト)
- TB (テラバイト)
通常、非修飾値はバイトとして扱われますが、小さな値は最も近いキロバイトに切り上げられます。
このパラメーターの有効な入力範囲は、1 バイトから2147483647 バイトです。 無制限の値を入力した場合、メッセージ サイズの制限は Drop ディレクトリに課されません。 既定値は unlimited です。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Enabled
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Enabled パラメーターは、外部コネクタを有効にするかどうかを指定します。 有効な値は、$True または $False です。 既定値は $true です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Identity パラメーターは、変更する外部コネクタを指定します。 Identity パラメーターには、外部コネクタ オブジェクトを表す次のいずれかの値を指定できます。
- GUID
- コネクタ名
- ServerName\ConnectorName
パラメーターのプロパティ
| 型: | ForeignConnectorIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-IsScopedConnector
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
IsScopedConnector パラメーターは、その他のメールボックス サーバーに対するコネクタの可用性を指定します。 このパラメーターの値が$falseされている場合、コネクタは Exchange organization内のすべてのメールボックス サーバーで使用できます。 このパラメーターの値が$trueされている場合、コネクタは、同じ Active Directory サイト内のメールボックス サーバーでのみ使用できます。 既定値は $false です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MaxMessageSize
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
MaxMessageSize パラメーターは、この外部コネクタを通過できるメッセージの最大サイズを指定します。
値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。
- B (バイト)
- KB (キロバイト)
- MB (メガバイト)
- GB (ギガバイト)
- TB (テラバイト)
通常、非修飾値はバイトとして扱われますが、小さな値は最も近いキロバイトに切り上げられます。
無制限の値を入力した場合、この外部コネクタにメッセージ サイズの制限は適用されません。 既定値は unlimited です。 このパラメーターの有効な入力範囲は、0 から2147483647 KB です。 MaxMessageSize パラメーターの値を 0 に設定した場合は、外部コネクタを効果的に無効にします。 ただし、Enabled 属性の値が$trueされたときに MaxMessageSize パラメーターの値を 0 に設定すると、イベント ログ エラーが生成されます。 外部コネクタを無効にするには、Enabled パラメーターを使用することをお勧めします。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Name パラメーターは、外部コネクタのわかりやすい名前を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-RelayDsnRequired
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
RelayDsnRequired パラメーターは、メッセージが Drop ディレクトリに書き込まれるときに、外部コネクタによってリレー配信状態通知 (DSN) が必要かどうかを指定します。 このパラメーターの有効な入力値は、$trueまたは$falseです。 既定値は $false です。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SourceTransportServers
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
SourceTransportServers パラメーターでは、この外部コネクタを使用するメールボックス サーバーの名前を指定します。 トランスポート サービスを実行している複数のメールボックス サーバーに 1 つの外部コネクタを配置すると、いずれかのサーバーが失敗した場合にフォールト トレランスと高可用性が提供されます。 このパラメーターの既定値は、この外部コネクタが最初にインストールされたメールボックス サーバーの名前です。
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"。
既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。