Set-OutboundConnector
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
クラウドベースの組織内の既存の送信コネクタを変更するには、Set-OutboundConnector コマンドレットを使用します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Set-OutboundConnector
[-Identity] <OutboundConnectorIdParameter>
[-AllAcceptedDomains <Boolean>]
[-CloudServicesMailEnabled <Boolean>]
[-Comment <String>]
[-Confirm]
[-ConnectorSource <TenantConnectorSource>]
[-ConnectorType <TenantConnectorType>]
[-Enabled <Boolean>]
[-IsTransportRuleScoped <Boolean>]
[-IsValidated <Boolean>]
[-LastValidationTimestamp <DateTime>]
[-Name <String>]
[-RecipientDomains <MultiValuedProperty>]
[-RouteAllMessagesViaOnPremises <Boolean>]
[-SenderRewritingEnabled <Boolean>]
[-SmartHosts <MultiValuedProperty>]
[-TestMode <Boolean>]
[-TlsDomain <SmtpDomainWithSubdomains>]
[-TlsSettings <TlsAuthLevel>]
[-UseMXRecord <Boolean>]
[-ValidationRecipients <String[]>]
[-WhatIf]
[<CommonParameters>] 説明
送信コネクタは、特定の構成オプションを必要とするリモート ドメインに電子メール メッセージを送信します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-OutboundConnector "Contoso Outbound Connector" -UseMxRecord $false -SmartHosts 192.168.0.1この例では、Contoso Outbound Connector という名前の既存の送信コネクタの設定を IP アドレス 192.168.0.1 のスマート ホストにルーティングするように変更します。
パラメーター
-AllAcceptedDomains
AllAcceptedDomains パラメーターは、メッセージ受信者がクラウドベース組織の承認済みドメインにあるハイブリッド組織で送信コネクタを使用するかどうかを指定します。 有効な値は次のとおりです。
- $true: 送信コネクタは、メッセージ受信者がクラウドベース組織の承認済みドメインにある場合にハイブリッド組織で使用されます。 この設定では、ConnectorType 値に OnPremises が必要です。
- $false: 送信コネクタはハイブリッド組織では使用されません。 これは既定の値です。
このパラメーターは、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 |
-CloudServicesMailEnabled
注: カスタマー サービスとサポート、または特定の製品ドキュメントを使用Microsoft指示がない限り、このパラメーターを使用しないことをお勧めします。 代わりに、ハイブリッド構成ウィザードを使用して、オンプレミスとクラウド組織の間のメール フローを構成します。 詳しくは、「 ハイブリッド構成ウィザード」をご覧ください。
CloudServicesMailEnabled パラメーターは、オンプレミスの Exchange 環境と Microsoft 365 の間のハイブリッド メール フローにコネクタを使用するかどうかを指定します。 具体的には、このパラメーターは、オンプレミスおよびクラウド組織の承認済みドメイン間で送信されるメッセージで、特定の内部 X-MS-Exchange-Organization-* メッセージ ヘッダーを処理する方法を制御します。 これらのヘッダーは、総称してクロスプレミス ヘッダーと呼ばれます。
有効な値は次のとおりです。
- $true: コネクタはハイブリッド組織のメール フローに使用されるため、クロスプレミス ヘッダーはコネクタを通過するメッセージで保持または昇格されます。 これは、ハイブリッド構成ウィザードによって作成されるコネクタの既定値です。 ハイブリッド組織の一方から他方に送信される送信メッセージ内の特定の X-MS-Exchange-Organization-* ヘッダーは、X-MS-Exchange-CrossPremises-* ヘッダーに変換され、メッセージに保持されます。 ハイブリッド組織の一方の側で他方から受信した受信メッセージの 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: コネクタは社内組織で使用されているドメインにサービスを提供します。
| Type: | TenantConnectorType |
| 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 パラメーターには、変更するコネクタを指定します。 コネクタを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
| Type: | OutboundConnectorIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IsTransportRuleScoped
IsTransportRuleScoped パラメーターは、送信コネクタがトランスポート ルール (メール フロー ルールとも呼ばれます) に関連付けられているかどうかを指定します。 有効な値は次のとおりです。
- $true: コネクタはトランスポート ルールに関連付けられています。
- $false: コネクタはトランスポート ルールに関連付けられません。 これは既定の値です。
New-TransportRuleまたは Set-TransportRule コマンドレットの RouteMessageOutboundConnector パラメーターを使用して、トランスポート 規則のスコープを送信コネクタに設定します。 トランスポート ルールの条件に一致するメッセージは、指定された送信コネクタを使用して宛先にルーティングされます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IsValidated
IsValidated パラメーターは、送信コネクタが検証されているかどうかを指定します。 有効な値は次のとおりです。
- $true: コネクタが検証されました。
- $false: コネクタが検証されていません。 これは既定の値です。
コネクタを検証するには、Validate-OutboundConnector コマンドレットを使用します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-LastValidationTimestamp
LastValidationTimestamp パラメーターは、送信コネクタが検証された日付/時刻を指定します。
このパラメーターの日付/時刻値を指定するには、次のいずれかのオプションを使用します。
- UTC で日付/時刻の値を指定します。たとえば、"2021-05-06 14:30:00z" です。
- ローカル タイム ゾーンの日付/時刻を UTC に変換する数式として、日付/時刻の値を指定します(例:
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime())。 詳細については、「Get-Date」を参照してください。
コネクタを検証するには、Validate-OutboundConnector コマンドレットを使用します。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Name
Name パラメーターは、コネクタの一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-RecipientDomains
RecipientDomains パラメーターは、送信コネクタがメールをルーティングするドメインを指定します。 複数のドメインをコンマで区切って指定できます。
*.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 |
-RouteAllMessagesViaOnPremises
RouteAllMessagesViaOnPremises パラメーターは、このコネクタによってサービスされるすべてのメッセージが、最初にオンプレミスの電子メール システムを介してルーティングされることを指定します。 有効な値は次のとおりです。
- $true: メッセージはオンプレミスの電子メール システムを介してルーティングされます。 この設定では、ConnectorType 値に OnPremises が必要です。
- $false: メッセージはオンプレミスの電子メール システムを介してルーティングされません。 これは既定の値です。
このパラメーターは、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 |
-SenderRewritingEnabled
SenderRewritingEnabled パラメーターは、通常 SRS 書き換えの対象となるすべてのメッセージが、オンプレミスの電子メール システムを介したルーティングのために書き換えられることを指定します。 有効な値は次のとおりです。
- $true: メッセージは、オンプレミスの電子メール システムを介してルーティングされる前に、必要に応じて SRS によって書き換えられます。 この設定では、ConnectorType 値に OnPremises が必要です。
- $false: メッセージは、オンプレミスの電子メール システムを介してルーティングされる前に SRS によって書き換えられません。 これは既定の値です。
このパラメーターは、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 |
-SmartHosts
SmartHosts パラメーターは、送信コネクタがメールのルーティングに使用するスマート ホストを指定します。 有効な値は次のとおりです。
- スマート ホスト サーバー、メール交換 (MX) レコード、アドレス (A) レコードの FQDN: たとえば、mail.contoso.com。
- 単一 IP アドレス: 10.10.1.1 など。
- クラスレス ドメイン間ルーティング (CIDR) IP アドレス範囲: たとえば、192.168.0.1/25。
複数の値をコンマで区切って指定できます。 "Value1","Value2",..."ValueN"
UseMxRecord パラメーターに$false値を使用する場合は、このパラメーターが必要です。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TestMode
TestMode パラメーターは、送信コネクタのテスト モードを有効または無効にするかどうかを指定します。 有効な値は次のとおりです。
- $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 |
-TlsDomain
TlsDomain パラメーターは、TLS セキュリティで保護された接続を確立するときに、送信コネクタがターゲット証明書の FQDN を確認するために使用するドメイン名を指定します。 このパラメーターの有効な値は SMTP ドメインです。
ワイルドカードは、ドメインのすべてのサブドメイン (例: *.contoso.com) を指定するためにサポートされていますが、ドメイン内にワイルドカード文字 (domain.*.contoso.com など) を埋め込むすることはできません。
このパラメーターは、TlsSettings 値が DomainValidation の場合にのみ意味があります。
| Type: | SmtpDomainWithSubdomains |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TlsSettings
TlsSettings パラメーターは、この送信コネクタにより確立された送信 TLS 接続に使用される TLS 認証レベルを指定します。 有効な値は次のとおりです。
- EncryptionOnly: TLS は通信チャネルを暗号化するためだけに使用されます。 証明書の認証は行われません。
- CertificateValidation: TLS を使用してチャネルを暗号化し、証明書チェーンの検証と失効リストのチェックが実行されます。
- DomainValidation: チャネルの暗号化と証明書の検証に加えて、送信コネクタは、ターゲット証明書の FQDN が TlsDomain パラメーターで指定されたドメインと一致することも確認します。
- $null (空白): これが既定値です。
| Type: | TlsAuthLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-UseMXRecord
UseMXRecord パラメーターで、コネクタの DNS ルーティングを有効または無効にできます。 有効な値は次のとおりです。
- $true: コネクタは、DNS ルーティング (DNS の MX レコード) を使用して電子メールを配信します。 これは既定の値です。
- $false: コネクタは、1 つ以上のスマート ホストに電子メールを配信します。 この設定では、SmartHosts 値に 1 つ以上のスマート ホストが必要です。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ValidationRecipients
ValidationRecipients パラメーターは、送信コネクタの検証受信者の電子メール アドレスを指定します。 複数のメール アドレスをコンマで区切って指定できます。
| Type: | String[] |
| 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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。