Set-InboundConnector
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
クラウドベースの組織内の既存の受信コネクタを変更するには、Set-InboundConnector コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
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
AssociatedAcceptedDomains パラメーターは、コネクタを使用するソース ドメインを、指定された承認済みドメインに制限します。 有効な値は、Microsoft 365 organizationで承認済みドメインとして構成されている SMTP ドメインです。
複数の値をコンマで区切って指定できます。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-CloudServicesMailEnabled
注: 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: コネクタはハイブリッド組織のメール フローに使用されないため、クロスプレミス ヘッダーはコネクタを通過するメッセージから削除されます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Comment
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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 Online, Exchange Online Protection |
-ConnectorSource
ConnectorSource パラメーターには、コネクタを作成する方法を指定します。 このパラメーターに対する有効な入力は以下の値です。
- Default: コネクタは手動で作成されています。 これは既定の値です。
- HybridWizard: コネクタはハイブリッド構成ウィザードによって自動的に作成されています。
- Migrated: コネクタは Microsoft Forefront Online Protection for Exchange で作成されています。
この値は変更しないことをお勧めします。
| Type: | TenantConnectorSource |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ConnectorType
ConnectorType パラメーターは、コネクタのサービスを利用するドメインのカテゴリーを指定します。 このパラメーターに対する有効な入力は以下の値です。
- Partner: コネクタは組織外のドメインにサービスを提供します。
- OnPremises: コネクタは社内組織で使用されているドメインにサービスを提供します。 SenderDomains パラメーターで指定されているクラウドベースのorganizationで受け入れられたドメインに対して、この値を使用します。
| Type: | TenantConnectorType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFSkipIPs
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 など。
複数の値をコンマで区切って指定できます。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFSkipLastIP
EFSkipIPs パラメーターは、コネクタの拡張フィルター処理の動作を指定します。 有効な値は次のとおりです。
- $true: 最後のメッセージ ソースのみがスキップされます。
- $false: EFSkipIP パラメーターで指定されたソース IP アドレスをスキップします。 IP アドレスが指定されていない場合、コネクタの拡張フィルター処理はコネクタで無効になります。 これは既定の値です。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFSkipMailGateway
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFTestMode
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EFUsers
EFUsers パラメーターは、コネクタの拡張フィルター処理が適用される受信者を指定します。 既定値は空白 ($null) です。つまり、コネクタの拡張フィルター処理はすべての受信者に適用されます。
複数の受信者電子メール アドレスをコンマで区切って指定できます。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Enabled
Enabled パラメーターで、コネクタを有効または無効にできます。 有効な値は次のとおりです。
- $true: コネクタが有効になっています。 これは既定の値です。
- $false: コネクタが無効になっています。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Identity
Identity パラメーターには、変更する受信コネクタを指定します。
| Type: | InboundConnectorIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Name
Name パラメーターは、コネクタのわかりやすい名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RequireTls
RequireTLS パラメーターは、コネクタによって受信されたすべてのメッセージに対して TLS 転送を必要とするかどうかを指定します。 有効な値は次のとおりです。
- $true: TLS 経由で送信されない場合はメッセージを拒否します。 これが既定値です
- $false: メッセージが TLS 経由で送信されない場合は、メッセージを許可します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RestrictDomainsToCertificate
RestrictDomainsToCertificate パラメーターは、メッセージがコネクタを使用する前に TLS 証明書のサブジェクト値をチェックするかどうかを指定します。 有効な値は次のとおりです。
- $true: メールは、送信元メール サーバーが認証に使用する TLS 証明書の Subject 値が TlsSenderCertificateName パラメーター値と一致する場合にのみ、コネクタを使用できます。
- $false: ソース電子メール サーバーが認証に使用する TLS 証明書のサブジェクト値は、そのソースからのメールがコネクタを使用するかどうかを制御しません。 これは既定の値です。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RestrictDomainsToIPAddresses
RestrictDomainsToIPAddresses パラメーターは、不明な送信元 IP アドレスからのメールを拒否するかどうかを指定します。 有効な値は次のとおりです。
- $true: 送信元 IP アドレスも SenderIPAddress パラメーターで指定されていない場合、SenderDomains パラメーターで指定されたドメインからのメールを自動的に拒否します。
- $false: 送信元 IP アドレスに基づいて SenderDomains パラメーターで指定されたドメインからのメールを自動的に拒否しないでください。 これは既定の値です。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ScanAndDropRecipients
このパラメーターは、Microsoft の内部使用のために予約されています。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-SenderDomains
SenderDomains パラメーターは、コネクタがメッセージを受け入れるソース ドメインを指定します。 有効な値は SMTP ドメインです。 ワイルドカードは、ドメインとすべてのサブドメイン (例: *.contoso.com) を示すためにサポートされていますが、ワイルドカード文字を埋め込むできません (たとえば、domain.*.contoso.com は無効です)。
複数のドメインをコンマで区切って指定できます。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-SenderIPAddresses
SenderIPAddresses パラメーターは、このコネクタがメッセージを受け入れるリモート IPV4 IP アドレスを指定します。 IPv6 アドレスはサポートされていません。 有効な値は次のとおりです。
- 単一の IP アドレス: たとえば、192.168.1.1。
- クラスレス ドメイン間ルーティング (CIDR) IP アドレス範囲: たとえば、192.168.0.1/25。 有効なサブネット マスク値は、/24 から /32 です。
複数の値をコンマで区切って指定できます。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TlsSenderCertificateName
TlsSenderCertificateName パラメーターは、RequireTls パラメーターの値が$trueされるときに使用される TLS 証明書を指定します。 有効な値は SMTP ドメインです。 ワイルドカードは、ドメインとすべてのサブドメイン (例: *.contoso.com) を示すためにサポートされていますが、ワイルドカード文字を埋め込むできません (たとえば、domain.*.contoso.com は無効です)。
| Type: | TlsCertificate |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TreatMessagesAsInternal
TreatMessagesAsInternal パラメーターは、オンプレミスのorganizationから送信されたメッセージを内部メッセージとして識別する代替メソッドを指定します。 このパラメーターの使用は、オンプレミスのorganizationで Exchange が使用されていない場合にのみ考慮する必要があります。 有効な値は次のとおりです。
- $true: 送信者のドメインが Microsoft 365 で構成されているドメインと一致する場合、メッセージは内部と見なされます。 この設定では、2010 以降がインストールされていない Microsoft 365 とオンプレミス組織間の内部メール フロー Exchange Server許可します。 ただし、この設定には潜在的なセキュリティ リスクがあります (たとえば、内部メッセージはスパム対策フィルター処理をバイパスします)、この設定を構成するときは注意が必要です。
- $false: メッセージは内部と見なされません。 これは既定の値です。
ハイブリッド環境では、ハイブリッド構成ウィザードでは、Microsoft 365 の受信コネクタとオンプレミスの Exchange organizationの送信コネクタ (CloudServicesMailEnabled パラメーター) で必要な設定が自動的に構成されるため、このパラメーターを使用する必要はありません。
注: 次のいずれかの条件が true の場合、このパラメーターを$true値に設定することはできません。
- CloudServicesMailEnabled パラメーターは、$true値に設定されます。
- ConnectorType パラメーター値が OnPremises ではありません。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TrustedOrganizations
TrustedOrganizations パラメーターは、信頼されたメール ソースである他の Microsoft 365 組織を指定します (たとえば、取得と合併後)。 このパラメーターは、2 つの Microsoft 365 組織間のメール フローでのみ機能するため、他のパラメーターは使用されません。
複数の値を入力し、既存のエントリを上書きするには、次の構文を使用します。 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 Online, Exchange Online Protection |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。