Set-InboundConnector
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
クラウドベースの組織内の既存の受信コネクタを変更するには、Set-InboundConnector コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Set-InboundConnector
[-Identity] <InboundConnectorIdParameter>
[-AssociatedAcceptedDomains <MultiValuedProperty>]
[-CloudServicesMailEnabled <Boolean>]
[-Comment <String>]
[-Confirm]
[-ConnectorSource <TenantConnectorSource>]
[-ConnectorType <TenantConnectorType>]
[-EFSkipIPs <MultiValuedProperty>]
[-EFSkipLastIP <Boolean>]
[-EFSkipMailGateway <MultiValuedProperty>]
[-EFTestMode <Boolean>]
[-EFUsers <MultiValuedProperty>]
[-Enabled <Boolean>]
[-Name <String>]
[-RequireTls <Boolean>]
[-RestrictDomainsToCertificate <Boolean>]
[-RestrictDomainsToIPAddresses <Boolean>]
[-ScanAndDropRecipients <MultiValuedProperty>]
[-SenderDomains <MultiValuedProperty>]
[-SenderIPAddresses <MultiValuedProperty>]
[-TlsSenderCertificateName <TlsCertificate>]
[-TreatMessagesAsInternal <Boolean>]
[-TrustedOrganizations <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
説明
受信コネクタは、特定の構成オプションを必要とするリモート ドメインから電子メール メッセージを受信します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.com
この例では、Contoso.com Inbound Connector という名前の既存の受信コネクタの次のような構成を変更しています。
コネクタのすべての受信メッセージに TLS 送信を要求する。
ドメイン名 contoso.com を含む通信の暗号化に使用する TLS 証明書を要求する。
パラメーター
-AssociatedAcceptedDomains
適用対象: Exchange Online、Exchange Online Protection
AssociatedAcceptedDomains パラメーターは、コネクタを使用するソース ドメインを、指定された承認済みドメインに制限します。 有効な値は、Microsoft 365 organizationで承認済みドメインとして構成されている SMTP ドメインです。
複数の値をコンマで区切って指定できます。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-CloudServicesMailEnabled
適用対象: Exchange Online、Exchange Online Protection
注: Microsoft カスタマー サービスとサポート、または特定の製品ドキュメントによって指示されない限り、このパラメーターを使用しないことをお勧めします。 代わりに、ハイブリッド構成ウィザードを使用して、オンプレミスとクラウド組織の間のメール フローを構成します。 詳しくは、「 ハイブリッド構成ウィザード」をご覧ください。
CloudServicesMailEnabled パラメーターは、オンプレミスの Exchange 環境と Microsoft 365 の間のハイブリッド メール フローにコネクタを使用するかどうかを指定します。 具体的には、このパラメーターは、特定の内部 X-MS-Exchange-Organization-* メッセージ ヘッダーを、オンプレミスおよびクラウド組織の承認済みドメイン間で送信されるメッセージで処理する方法を制御します。 これらのヘッダーは、総称してクロスプレミス ヘッダーと呼ばれます。
有効な値は次のとおりです。
- $true: コネクタはハイブリッド組織のメール フローに使用されるため、クロスプレミス ヘッダーはコネクタを通過するメッセージで保持または昇格されます。 この値は、ハイブリッド構成ウィザードによって作成されるコネクタの既定値です。 ハイブリッド organizationの一方の側から他方に送信される送信メッセージ内の特定の X-MS-Exchange-Organization-* ヘッダーは、X-MS-Exchange-CrossPremises-* ヘッダーに変換され、メッセージに保持されます。 ハイブリッド organizationの一方の側で受信した受信メッセージの X-MS-Exchange-CrossPremises-* ヘッダーは、X-MS-Exchange-Organization-* ヘッダーに昇格されます。 これらの昇格されたヘッダーは、メッセージに既に存在する同じ X-MS-Exchange-Organization-* ヘッダーのインスタンスを置き換えます。
- $false: コネクタはハイブリッド組織のメール フローに使用されないため、クロスプレミス ヘッダーはコネクタを通過するメッセージから削除されます。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Comment
適用対象: Exchange Online、Exchange Online Protection
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Confirm
適用対象: Exchange Online、Exchange Online Protection
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$false
を使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
型: | SwitchParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
Aliases: | cf |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ConnectorSource
適用対象: Exchange Online、Exchange Online Protection
ConnectorSource パラメーターには、コネクタを作成する方法を指定します。 このパラメーターに対する有効な入力は以下の値です。
- Default: コネクタは手動で作成されています。 この値が既定値です。
- HybridWizard: コネクタはハイブリッド構成ウィザードによって自動的に作成されています。
- Migrated: コネクタは Microsoft Forefront Online Protection for Exchange で作成されています。
この値は変更しないことをお勧めします。
パラメーターのプロパティ
型: | TenantConnectorSource |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ConnectorType
適用対象: Exchange Online、Exchange Online Protection
ConnectorType パラメーターは、コネクタのサービスを利用するドメインのカテゴリーを指定します。 このパラメーターに対する有効な入力は以下の値です。
- Partner: コネクタは組織外のドメインにサービスを提供します。
- OnPremises: コネクタは社内組織で使用されているドメインにサービスを提供します。 OnPremises コネクタは、コネクタと追加の要件に一致する電子メールに特別な権限を付与します。 たとえば、テナント経由でインターネットの宛先へのリレーを許可したり、オンプレミスやその他の環境からのメールを内部 (ハイブリッド構成) として昇格させたり、他のより複雑なメール フローを有効にしたりできます。
パラメーターのプロパティ
型: | TenantConnectorType |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-EFSkipIPs
適用対象: Exchange Online、Exchange Online Protection
EFSkipIP パラメーターは、EFSkipLastIP パラメーター値が$falseされたときに、コネクタの拡張フィルター処理でスキップするソース IP アドレスを指定します。 有効な値は次のとおりです。
- 単一の IP アドレス: たとえば、192.168.1.1。
- IP アドレス範囲: たとえば、192.168.0.1-192.168.0.254。
- クラスレスドメイン間ルーティング (CIDR) の IP アドレス範囲: 192.168.3.1/24 など。
複数の値をコンマで区切って指定できます。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-EFSkipLastIP
適用対象: Exchange Online、Exchange Online Protection
EFSkipIPs パラメーターは、コネクタの拡張フィルター処理の動作を指定します。 有効な値は次のとおりです。
- $true: 最後のメッセージ ソースのみがスキップされます。
- $false: EFSkipIP パラメーターで指定されたソース IP アドレスをスキップします。 IP アドレスが指定されていない場合、コネクタの拡張フィルター処理はコネクタで無効になります。 この値が既定値です。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-EFSkipMailGateway
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-EFTestMode
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-EFUsers
適用対象: Exchange Online、Exchange Online Protection
EFUsers パラメーターは、コネクタの拡張フィルター処理が適用される受信者を指定します。 既定値は空白 ($null) です。つまり、コネクタの拡張フィルター処理はすべての受信者に適用されます。
複数の受信者電子メール アドレスをコンマで区切って指定できます。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Enabled
適用対象: Exchange Online、Exchange Online Protection
Enabled パラメーターで、コネクタを有効または無効にできます。 有効な値は次のとおりです。
- $true: コネクタが有効になっています。 この値が既定値です。
- $false: コネクタが無効になっています。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Identity
適用対象: Exchange Online、Exchange Online Protection
Identity パラメーターには、変更する受信コネクタを指定します。
パラメーターのプロパティ
型: | InboundConnectorIdParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | 1 |
必須: | True |
パイプラインからの値: | True |
プロパティ名別のパイプラインからの値: | True |
残りの引数からの値: | False |
-Name
適用対象: Exchange Online、Exchange Online Protection
Name パラメーターは、コネクタのわかりやすい名前を指定します。
パラメーターのプロパティ
型: | String |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-RequireTls
適用対象: Exchange Online、Exchange Online Protection
RequireTLS パラメーターは、パートナー型コネクタによって受信されたすべてのメッセージに対して TLS 転送を必要とするかどうかを指定します。 有効な値は次のとおりです。
- $true: TLS 経由で送信されない場合はメッセージを拒否します。 この値は既定値です
- $false: メッセージが TLS 経由で送信されない場合は、メッセージを許可します。
注: このパラメーターは、パートナー型コネクタにのみ適用されます。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-RestrictDomainsToCertificate
適用対象: Exchange Online、Exchange Online Protection
RestrictDomainsToCertificate パラメーターは、メッセージがパートナー型コネクタを使用する前に、TLS 証明書のサブジェクト値をチェックするかどうかを指定します。 有効な値は次のとおりです。
- $true: メールは、送信元メール サーバーが認証に使用する TLS 証明書の Subject 値が TlsSenderCertificateName パラメーター値と一致する場合にのみ、コネクタを使用できます。
- $false: ソース電子メール サーバーが認証に使用する TLS 証明書のサブジェクト値は、そのソースからのメールがコネクタを使用するかどうかを制御しません。 この値が既定値です。
注: このパラメーターは、パートナー型コネクタにのみ適用されます。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-RestrictDomainsToIPAddresses
適用対象: Exchange Online、Exchange Online Protection
RestrictDomainsToIPAddresses パラメーターは、パートナー型コネクタの不明な送信元 IP アドレスからのメールを拒否するかどうかを指定します。 有効な値は次のとおりです。
- $true: 送信元 IP アドレスも SenderIPAddress パラメーターで指定されていない場合、SenderDomains パラメーターで指定されたドメインからのメールを自動的に拒否します。
- $false: 送信元 IP アドレスに基づいて SenderDomains パラメーターで指定されたドメインからのメールを自動的に拒否しないでください。 この値が既定値です。
注: このパラメーターは、パートナー型コネクタにのみ適用されます。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-ScanAndDropRecipients
適用対象: Exchange Online、Exchange Online Protection
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-SenderDomains
適用対象: Exchange Online、Exchange Online Protection
SenderDomains パラメーターは、パートナー型コネクタがメッセージを受け入れるソース ドメインを指定します (パートナー型コネクタのスコープを制限します)。 有効な値は SMTP ドメインです。 ワイルドカードは、ドメインとすべてのサブドメイン ( *.contoso.com
など) を示すためにサポートされています。 ただし、ワイルドカード文字を埋め込むことはできません (たとえば、 ___domain.*.contoso.com
は無効です)。
複数のドメインをコンマで区切って指定できます。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-SenderIPAddresses
適用対象: Exchange Online、Exchange Online Protection
SenderIPAddresses パラメーターは、RestrictDomainsToIPAddresses パラメーターの値が$trueされたときに、パートナーの種類コネクタがメッセージを受け入れるソース IPV4 IP アドレスを指定します。 有効な値は次のとおりです。
- 単一の IP アドレス: たとえば、192.168.1.1。
- クラスレス ドメイン間ルーティング (CIDR) IP アドレス範囲: たとえば、192.168.0.1/25。 有効なサブネット マスク値は、/24 から /32 です。 @@ -435,6 +441,8 @@ 複数の IP アドレスをコンマで区切って指定できます。
IPv6 アドレスはサポートされていません。
注: このパラメーターは、RestrictDomainsToIPAddresses パラメーターの値が$trueされている場合にのみ、パートナー型コネクタに適用されます。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-TlsSenderCertificateName
適用対象: Exchange Online、Exchange Online Protection
TlsSenderCertificateName パラメーターは、RequireTls パラメーターの値が$trueされるときに使用される TLS 証明書を指定します。 有効な値は SMTP ドメインです。 ワイルドカードは、ドメインとすべてのサブドメイン (例: *.contoso.com) を示すためにサポートされていますが、ワイルドカード文字 (例: ___domain.*.contoso.com が無効) を埋め込むできません。
パラメーターのプロパティ
型: | TlsCertificate |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-TreatMessagesAsInternal
適用対象: Exchange Online、Exchange Online Protection
TreatMessagesAsInternal パラメーターは、オンプレミスのorganizationから送信されたメッセージを内部メッセージとして識別する代替メソッドを指定します。 このパラメーターの使用は、オンプレミスのorganizationで Exchange が使用されていない場合にのみ考慮する必要があります。 有効な値は次のとおりです。
- $true: 送信者のドメインが Microsoft 365 で構成されているドメインと一致する場合、メッセージは内部と見なされます。 この設定では、2010 以降がインストールされていない Microsoft 365 とオンプレミス組織間の内部メール フロー Exchange Server許可します。 ただし、この設定には潜在的なセキュリティ リスクがあります (たとえば、内部メッセージはスパム対策フィルター処理をバイパスします)、この設定を構成するときは注意が必要です。
- $false: メッセージは内部と見なされません。 この値が既定値です。
ハイブリッド環境では、ハイブリッド構成ウィザードでは、Microsoft 365 の受信コネクタとオンプレミスの Exchange organizationの送信コネクタ (CloudServicesMailEnabled パラメーター) で必要な設定が自動的に構成されるため、このパラメーターを使用する必要はありません。
注: 次のいずれかの条件が true の場合、このパラメーターを$true値に設定することはできません。
- CloudServicesMailEnabled パラメーターは、$true値に設定されます。
- ConnectorType パラメーター値が OnPremises ではありません。
パラメーターのプロパティ
型: | Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-TrustedOrganizations
適用対象: Exchange Online、Exchange Online Protection
TrustedOrganizations パラメーターは、信頼されたメール ソースである他の Microsoft 365 組織を指定します (たとえば、取得と合併後)。 このパラメーターは、2 つの Microsoft 365 組織間のメール フローでのみ機能するため、他のパラメーターは使用されません。
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: 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 Online、Exchange Online Protection
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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。