New-ForeignConnector
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
メールボックス サーバーのトランスポート サービスで新しい外部コネクタを作成するには、New-ForeignConnector コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-ForeignConnector
[-Name] <String>
-AddressSpaces <MultiValuedProperty>
[-Confirm]
[-DomainController <Fqdn>]
[-IsScopedConnector <Boolean>]
[-SourceTransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] 説明
外部コネクタは、主要なトランスポート メカニズムとして SMTP を使用しないローカルのメッセージング サーバーに対してメッセージを送信するために、メールボックス サーバーのトランスポート サービスでドロップ ディレクトリを使用します。 これらのメッセージング サーバーは、外部ゲートウェイ サーバーとも呼ばれます。 外部ゲートウェイ サーバーの例としては、サード パーティの FAX ゲートウェイ サーバーがあります。 外部コネクタには、SMTP または SMTP 以外のアドレス スペースを割り当てることができます。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-ForeignConnector -Name "Contoso Foreign Connector" -AddressSpaces "X400:c=US;a=Fabrikam;P=Contoso;5" -SourceTransportServers Hub01,Hub02この例では、次のプロパティを持つ外部コネクタが作成されます。
- コネクタ名:Contoso Foreign Connector
- アドレス スペース:"c=US;a=Fabrikam;P=Contoso"
- アドレス スペースの種類:X.400
- アドレス スペースのコスト:5
- ソース トランスポート サーバー:Hub01 および Hub02
パラメーター
-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")。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-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 |
-Name
Name パラメーターには、外部コネクタの名前を指定します。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| 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 つの外部コネクタが複数のサーバーをホーム サーバーとすることによって、いずれかのメールボックス サーバーで障害が発生した場合のフォールト トレランスと高可用性を実現することができます。 このパラメーターの既定値は、外部コネクタが最初にインストールされたサーバーの名前です。
Update 値にスペースが含まれている場合、または引用符が必要な場合は、次の構文を使用します。 "Value1","Value2",..."ValueN"
| 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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。