New-InboundConnector

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

クラウドベースの組織内の新しい受信コネクタを作成するには、New-InboundConnector コマンドレットを使用します。

: 受信コネクタの作成は、Microsoft 365 E5 開発者サブスクリプションでは制限されています。 影響を受ける組織でサポート チケットを開いても問題ありません。

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

構文

Default (既定)

New-InboundConnector
    [-Name] <String>
    -SenderDomains <MultiValuedProperty>
    [-AssociatedAcceptedDomains <MultiValuedProperty>]
    [-ClientHostNames <MultiValuedProperty>]
    [-CloudServicesMailEnabled <Boolean>]
    [-Comment <String>]
    [-Confirm]
    [-ConnectorSource <TenantConnectorSource>]
    [-ConnectorType <TenantConnectorType>]
    [-EFSkipIPs <MultiValuedProperty>]
    [-EFSkipLastIP <Boolean>]
    [-EFSkipMailGateway <MultiValuedProperty>]
    [-EFTestMode <Boolean>]
    [-EFUsers <MultiValuedProperty>]
    [-Enabled <Boolean>]
    [-RequireTls <Boolean>]
    [-RestrictDomainsToCertificate <Boolean>]
    [-RestrictDomainsToIPAddresses <Boolean>]
    [-ScanAndDropRecipients <MultiValuedProperty>]
    [-SenderIPAddresses <MultiValuedProperty>]
    [-TlsSenderCertificateName <TlsCertificate>]
    [-TreatMessagesAsInternal <Boolean>]
    [-TrustedOrganizations <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

説明

受信コネクタは、特定の構成オプションを必要とするリモート ドメインから電子メール メッセージを受信します。

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

例 1

New-InboundConnector -Name "Contoso Inbound Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainsToIPAddresses $true

この例では、次のようなプロパティの Contoso Inbound Connector という名前の受信コネクタを作成しています。

  • ドメイン contoso.com とすべてのサブドメインからの受信接続を待機します。
  • contoso.com と IP 範囲 192.168.0.1/25 からのメールのみを受信します。 他の IP アドレス contoso.com 送信されたメールは拒否されます。

例 2

New-InboundConnector -Name "Contoso Inbound Secure Connector" -SenderDomains *.contoso.com -SenderIPAddresses 192.168.0.1/25 -RestrictDomainsToIPAddresses $true -RequireTLS $true -TlsSenderCertificateName *.contoso.com

この例では、Contoso Inbound Secure Connector という名前の受信コネクタを作成し、すべてのメッセージに TLS 送信を要求しています。

パラメーター

-AssociatedAcceptedDomains

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

AssociatedAcceptedDomains パラメーターは、コネクタを使用するソース ドメインを、指定された承認済みドメインに制限します。 有効な値は、Microsoft 365 organization で承認済みドメインとして構成されている SMTP ドメインです。

複数の値をコンマで区切って指定できます。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ClientHostNames

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

{{ Fill ClientHostNames Description }}

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-CloudServicesMailEnabled

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

: Microsoft カスタマー サービスとサポート、または特定の製品ドキュメントから指示がない限り、このパラメーターを使用しないことをお勧めします。 代わりに、ハイブリッド構成ウィザードを使用して、オンプレミス組織とクラウド組織間のメール フローを構成します。 詳しくは、「 ハイブリッド構成ウィザード」をご覧ください。

CloudServicesMailEnabled パラメーターは、オンプレミスの Exchange 環境と Microsoft 365 の間のハイブリッド メール フローにコネクタを使用するかどうかを指定します。 具体的には、このパラメーターは、オンプレミス組織とクラウド組織内の承認済みドメインの間で送信されるメッセージで、特定の内部 X-MS-Exchange-Organization-* メッセージ ヘッダーを処理する方法を制御します。 これらのヘッダーは、総称してクロスプレミス ヘッダーと呼ばれます。

有効な値は次のとおりです。

  • $true: コネクタはハイブリッド組織のメール フローに使用されるため、コネクタを通過するメッセージでクロスプレミス ヘッダーが保持または昇格されます。 この値は、ハイブリッド構成ウィザードによって作成されたコネクタの既定値です。 ハイブリッド組織の一方の側から他方の側に送信される送信メッセージ内の特定の X-MS-Exchange-Organization-* organization ヘッダーは、X-MS-Exchange-CrossPremises-* ヘッダーに変換されるため、メッセージ内で保持されます。 ハイブリッド組織の一方の側で他方の側から受信した受信メッセージの X-MS-Exchange-CrossPremises-* organization ヘッダーは、X-MS-Exchange-Organization-* ヘッダーに昇格されます。 これらの昇格されたヘッダーは、メッセージに既に存在する同じ X-MS-Exchange-Organization-* ヘッダーのインスタンスを置き換えます。
  • $false: コネクタはハイブリッド組織のメール フローには使用されないため、コネクタを通過するメッセージからクロスプレミス ヘッダーが削除されます。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Comment

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Confirm

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:Cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ConnectorSource

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

ConnectorSource パラメーターには、コネクタを作成する方法を指定します。 このパラメーターに対する有効な入力は以下の値です。

  • Default: コネクタは手動で作成されています。 この値が既定値です。
  • HybridWizard: コネクタはハイブリッド構成ウィザードによって自動的に作成されています。
  • Migrated: コネクタは Microsoft Forefront Online Protection for Exchange で作成されています。

この値は変更しないことをお勧めします。

パラメーターのプロパティ

型:TenantConnectorSource
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ConnectorType

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

ConnectorType パラメーターは、コネクタがメッセージを受け入れるソース ドメインのカテゴリを指定します。 有効な値は次のとおりです。

  • パートナー: 外部パートナーまたはサービス。
  • OnPremises: コネクタは社内組織で使用されているドメインにサービスを提供します。 オンプレミス コネクタは、コネクタと追加の要件に一致するメールに特別な権限を付与します。 たとえば、テナントを介したインターネットの宛先へのリレーを許可する、(ハイブリッド構成で) オンプレミスまたはその他の環境からの電子メールを内部として昇格する、その他のより複雑なメール フローを有効にするなどです。

パラメーターのプロパティ

型:TenantConnectorType
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EFSkipIPs

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

EFSkipIPs パラメーターは、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、オンプレミス メールボックス用の組み込みセキュリティ アドオン

EFSkipIPs パラメーターは、コネクタの拡張フィルター処理の動作を指定します。 有効な値は次のとおりです。

  • $true: 最後のメッセージ ソースのみスキップされます。
  • $false: EFSkipIPs パラメーターで指定されたソース IP アドレスをスキップします。 IP アドレスが指定されていない場合、コネクタの拡張フィルターはコネクタで無効になります。 この値が既定値です。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EFSkipMailGateway

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EFTestMode

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-EFUsers

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

EFUsers パラメーターは、コネクタの拡張フィルター処理が適用される受信者を指定します。 既定値は空白 ($null) で、コネクタの拡張フィルターがすべての受信者に適用されます。

複数の受信者電子メール アドレスをコンマで区切って指定できます。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Enabled

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

Enabled パラメーターで、コネクタを有効または無効にできます。 有効な値は次のとおりです。

  • $true: コネクタが有効になっています。 この値が既定値です。
  • $false: コネクタは無効になっています。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Name

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:1
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RequireTls

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

RequireTLS パラメーターは、パートナーの種類のコネクタによって受信されるすべてのメッセージについて、TLS 送信を要求するかどうかを指定します。 有効な値は次のとおりです。

  • $true: TLS 経由で送信されていない場合はメッセージを拒否します。 この値は既定値です
  • $false: TLS 経由で送信されていないメッセージを許可します。

: このパラメーターは、パートナー タイプのコネクタにのみ適用されます。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RestrictDomainsToCertificate

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

RestrictDomainsToCertificate パラメーターは、メッセージでパートナー タイプ コネクタを使用できるようになる前に、TLS 証明書のサブジェクト値をチェックするかどうかを指定します。 有効な値は次のとおりです。

  • $true: メールは、ソース電子メール サーバーが認証に使用する TLS 証明書の [件名] の値が TlsSenderCertificateName パラメーターの値と一致する場合にのみ、コネクタの使用が許可されます。
  • $false: ソース電子メール サーバーが認証に使用する TLS 証明書の件名の値は、そのソースからのメールがコネクタを使用するかどうかを制御しません。 この値が既定値です。

: このパラメーターは、パートナー タイプのコネクタにのみ適用されます。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RestrictDomainsToIPAddresses

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

RestrictDomainsToIPAddresses パラメーターは、パートナー タイプのコネクタの不明な送信元 IP アドレスからのメールを拒否するかどうかを指定します。 有効な値は次のとおりです。

  • $true: ソース IP アドレスが SenderIPAddress パラメーターで指定されていない場合、SenderDomains パラメーターで指定されたドメインからのメールを自動的に拒否します。
  • $false: ソース IP アドレスに基づいて SenderDomains パラメーターで指定されたドメインからのメールを自動的に拒否しないでください。 この値が既定値です。

: このパラメーターは、パートナー タイプのコネクタにのみ適用されます。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ScanAndDropRecipients

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SenderDomains

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

SenderDomains パラメーターは、パートナーの種類のコネクタがメッセージを受け入れるソース ドメインを指定します (パートナーの種類のコネクタの範囲を制限します)。 有効な値は SMTP ドメインです。 ワイルドカードは、ドメインとすべてのサブドメイン ( *.contoso.com など) を示すためにサポートされています。 ただし、ワイルドカード文字を埋め込むことはできません (たとえば、 domain.*.contoso.com は無効)。

複数のドメインをコンマで区切って指定できます。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SenderIPAddresses

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

SenderIPAddresses パラメーターは、RestrictDomainsToIPAddresses パラメーターの値が $true の場合にパートナー タイプ コネクタがメッセージを受け入れる送信元 IPV4 IP アドレスを指定します。 有効な値は次のとおりです。

  • 単一の IP アドレス: たとえば、192.168.1.1。
  • クラスレス ドメイン間ルーティング (CIDR) IP アドレス範囲: たとえば、192.168.0.1/25。 有効なサブネット マスク値は /24 から /32 です。

複数の IP アドレスをコンマで区切って指定できます。

IPv6 アドレスはサポートされていません。

: このパラメーターは、RestrictDomainsToIPAddresses パラメーターの値が $true の場合にのみ、パートナーの種類のコネクタに適用されます。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TlsSenderCertificateName

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

TlsSenderCertificateName パラメーターは、RequireTls パラメーターの値が $true であるときに使用される TLS 証明書を指定します。 有効な値は SMTP ドメインです。 ワイルドカードは、ドメインとすべてのサブドメイン (*.contoso.com など) を示すためにサポートされていますが、ワイルドカード文字を埋め込むことはできません (たとえば、domain.*.contoso.com は無効です)。

パラメーターのプロパティ

型:TlsCertificate
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TreatMessagesAsInternal

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

TreatMessagesAsInternal パラメーターは、オンプレミスorganizationから送信されたメッセージを内部メッセージとして識別するための代替メソッドを指定します。 このパラメーターの使用は、オンプレミス organization で Exchange を使用していない場合にのみ検討してください。 有効な値は次のとおりです。

  • $true: 送信者のドメインが Microsoft 365 で構成されているドメインと一致する場合、メッセージは内部メッセージと見なされます。 この設定により、Microsoft 365 と、Exchange Server 2010 以降がインストールされていないオンプレミスの組織との間での内部メール フローが許可されます。 ただし、この設定には潜在的なセキュリティ リスクがあるため (たとえば、内部メッセージでスパム対策フィルター処理がバイパスされるなど)、この設定を構成するときは注意が必要です。
  • $false: メッセージは内部メッセージと見なされません。 この値が既定値です。

ハイブリッド環境では、ハイブリッド構成ウィザードによって、Microsoft 365 の受信コネクタとオンプレミスの Exchange organization の送信コネクタに必要な設定が自動的に構成されるため、このパラメーターを使用する必要はありません (CloudServicesMailEnabled パラメーター)。

: 次のいずれかの条件に該当する場合、このパラメーターを値 $true に設定することはできません。

  • CloudServicesMailEnabled パラメーターの値が $true に設定されている。
  • ConnectorType パラメーターの値が OnPremises ではありません。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-TrustedOrganizations

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

TrustedOrganizations パラメーターは、信頼されたメール ソースである他の Microsoft 365 組織を指定します (買収や合併後など)。 複数の Microsoft 365 組織をコンマで区切って指定できます。

このパラメーターは、2 つの Microsoft 365 組織間のメール フローに対してのみ機能するため、他のパラメーターは使用されません。

パラメーターのプロパティ

型:MultiValuedProperty
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン

[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False
Aliases:wi

パラメーター セット

(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

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