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
適用対象: Exchange Online、Exchange Online Protection
AllAcceptedDomains パラメーターは、メッセージ受信者がクラウドベースのorganizationの承認済みドメインにあるハイブリッド組織で送信コネクタを使用するかどうかを指定します。 有効な値は次のとおりです。
- $true: 送信コネクタは、メッセージ受信者がクラウドベースのorganizationの承認済みドメインにある場合にハイブリッド組織で使用されます。 この設定では、ConnectorType 値に OnPremises が必要です。
- $false: 送信コネクタはハイブリッド組織では使用されません。 これは既定の値です。
このパラメーターは、OnPremises コネクタに対してのみ有効です。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | 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 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Comment
適用対象: Exchange Online、Exchange Online Protection
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
適用対象: Exchange Online、Exchange Online Protection
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ConnectorSource
適用対象: Exchange Online、Exchange Online Protection
ConnectorSource パラメーターには、コネクタを作成する方法を指定します。 有効な値は次のとおりです。
- Default: コネクタは手動で作成されています。 これは手動で作成されたコネクタの既定値であり、この値は変更しないことをお勧めします。
- HybridWizard: コネクタはハイブリッド構成ウィザードによって自動的に作成されています。
- Migrated: コネクタは Microsoft Forefront Online Protection for Exchange で作成されています。
| 型: | TenantConnectorSource |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ConnectorType
適用対象: Exchange Online、Exchange Online Protection
ConnectorType パラメーターは、コネクタのサービスを利用するドメインのカテゴリーを指定します。 有効な値は次のとおりです。
- Partner: コネクタは組織外のドメインにサービスを提供します。
- OnPremises: コネクタは社内組織で使用されているドメインにサービスを提供します。
| 型: | TenantConnectorType |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Enabled
適用対象: Exchange Online、Exchange Online Protection
Enabled パラメーターは、送信コネクタを有効または無効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: コネクタが有効になっています。 これは既定の値です。
- $false: コネクタが無効になっています。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Identity
適用対象: Exchange Online、Exchange Online Protection
Identity パラメーターには、変更するコネクタを指定します。 コネクタを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- 識別名 (DN)
- GUID
| 型: | OutboundConnectorIdParameter |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-IsTransportRuleScoped
適用対象: Exchange Online、Exchange Online Protection
IsTransportRuleScoped パラメーターは、送信コネクタがトランスポート ルール (メール フロー ルールとも呼ばれます) に関連付けられているかどうかを指定します。 有効な値は次のとおりです。
- $true: コネクタはトランスポート ルールに関連付けられています。
- $false: コネクタがトランスポート ルールに関連付けられていない。 これは既定の値です。
New-TransportRule または Set-TransportRule コマンドレットの RouteMessageOutboundConnector パラメーターを使用して、トランスポート 規則のスコープを送信コネクタに設定します。 トランスポート ルールの条件に一致するメッセージは、指定された送信コネクタを使用して宛先にルーティングされます。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IsValidated
適用対象: Exchange Online、Exchange Online Protection
IsValidated パラメーターは、送信コネクタが検証されているかどうかを指定します。 有効な値は次のとおりです。
- $true: コネクタが検証されました。
- $false: コネクタが検証されていません。 これは既定の値です。
コネクタを検証するには、Validate-OutboundConnector コマンドレットを使用します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LastValidationTimestamp
適用対象: Exchange Online、Exchange Online Protection
LastValidationTimestamp パラメーターは、送信コネクタが検証された日付/時刻を指定します。
このパラメーターの日付/時刻値を指定するには、次のいずれかのオプションを使用します。
- UTC で日付/時刻の値を指定します。たとえば、"2021-05-06 14:30:00z" です。
- ローカル タイム ゾーンの日付/時刻を UTC に変換する数式として、日付/時刻の値を指定します。たとえば、
(Get-Date "5/6/2021 9:30 AM").ToUniversalTime()。 詳細については、「Get-Date」を参照してください。
コネクタを検証するには、Validate-OutboundConnector コマンドレットを使用します。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
適用対象: Exchange Online、Exchange Online Protection
Name パラメーターは、コネクタの一意の名前を指定します。 最大の長さは 64 文字です。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RecipientDomains
適用対象: Exchange Online、Exchange Online Protection
RecipientDomains パラメーターは、送信コネクタがメールをルーティングするドメインを指定します。 複数のドメインをコンマで区切って指定できます。
*.contoso.com の例に示すように、ワイルドカード文字を使用して、指定したドメインのすべてのサブドメインを指定できます。 ただし、次の例に示すように、ワイルドカード文字を埋め込むはできません:___domain.*.contoso.com。
| 型: | MultiValuedProperty |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RouteAllMessagesViaOnPremises
適用対象: Exchange Online、Exchange Online Protection
RouteAllMessagesViaOnPremises パラメーターは、このコネクタによってサービスされるすべてのメッセージが、最初にオンプレミスの電子メール システムを介してルーティングされることを指定します。 有効な値は次のとおりです。
- $true: メッセージはオンプレミスの電子メール システムを介してルーティングされます。 この設定では、ConnectorType 値に OnPremises が必要です。
- $false: メッセージはオンプレミスの電子メール システムを介してルーティングされません。 これは既定の値です。
このパラメーターは、OnPremises コネクタに対してのみ有効です。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SenderRewritingEnabled
適用対象: Exchange Online、Exchange Online Protection
SenderRewritingEnabled パラメーターは、通常 SRS 書き換えの対象となるすべてのメッセージが、オンプレミスの電子メール システムを介したルーティングのために書き換えられることを指定します。 有効な値は次のとおりです。
- $true: メッセージは、オンプレミスの電子メール システムを介してルーティングされる前に、必要に応じて SRS によって書き換えられます。 この設定では、ConnectorType 値に OnPremises が必要です。
- $false: メッセージは、オンプレミスの電子メール システムを介してルーティングされる前に SRS によって書き換えられません。 これは既定の値です。
このパラメーターは、OnPremises コネクタに対してのみ有効です。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SmartHosts
適用対象: Exchange Online、Exchange Online Protection
SmartHosts パラメーターは、送信コネクタがメールのルーティングに使用するスマート ホストを指定します。 有効な値は次のとおりです。
- スマート ホスト サーバー、メール交換 (MX) レコード、アドレス (A) レコードの FQDN: たとえば、mail.contoso.com。
- 単一 IP アドレス: 10.10.1.1 など。
- クラスレス ドメイン間ルーティング (CIDR) IP アドレス範囲: たとえば、192.168.0.1/25。
複数の値をコンマで区切って指定できます: "Value1","Value2",..."ValueN"。
UseMxRecord パラメーターに$false値を使用する場合は、このパラメーターが必要です。
| 型: | MultiValuedProperty |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TestMode
適用対象: Exchange Online、Exchange Online Protection
TestMode パラメーターは、送信コネクタのテスト モードを有効または無効にするかどうかを指定します。 有効な値は次のとおりです。
- $true: テスト モードが有効になっています。
- $false: テスト モードが無効になっています。 これは既定の値です。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TlsDomain
適用対象: Exchange Online、Exchange Online Protection
TlsDomain パラメーターは、TLS セキュリティで保護された接続を確立するときに、送信コネクタがターゲット証明書の FQDN を確認するために使用するドメイン名を指定します。 このパラメーターの有効な値は SMTP ドメインです。
ワイルドカードは、ドメインのすべてのサブドメイン (例: *.contoso.com) を指定するためにサポートされていますが、ドメイン内にワイルドカード文字を埋め込む(例: ___domain.*.contoso.com)。
このパラメーターは、TlsSettings 値が DomainValidation の場合にのみ意味があります。
| 型: | SmtpDomainWithSubdomains |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TlsSettings
適用対象: Exchange Online、Exchange Online Protection
TlsSettings パラメーターは、この送信コネクタにより確立された送信 TLS 接続に使用される TLS 認証レベルを指定します。 有効な値は次のとおりです。
- EncryptionOnly: TLS は通信チャネルを暗号化するためだけに使用されます。 証明書の認証は行われません。
- CertificateValidation: TLS を使用してチャネルを暗号化し、証明書チェーンの検証と失効リストのチェックが実行されます。
- DomainValidation: チャネルの暗号化と証明書の検証に加えて、送信コネクタは、ターゲット証明書の FQDN が TlsDomain パラメーターで指定されたドメインと一致することも確認します。
- $null (空白): これが既定値です。
| 型: | TlsAuthLevel |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UseMXRecord
適用対象: Exchange Online、Exchange Online Protection
UseMXRecord パラメーターで、コネクタの DNS ルーティングを有効または無効にできます。 有効な値は次のとおりです。
- $true: コネクタは、DNS ルーティング (DNS の MX レコード) を使用して電子メールを配信します。 これは既定の値です。
- $false: コネクタは、1 つ以上のスマート ホストに電子メールを配信します。 この設定では、SmartHosts 値に 1 つ以上のスマート ホストが必要です。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ValidationRecipients
適用対象: Exchange Online、Exchange Online Protection
ValidationRecipients パラメーターは、送信コネクタの検証受信者の電子メール アドレスを指定します。 複数のメール アドレスをコンマで区切って指定できます。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
適用対象: Exchange Online、Exchange Online Protection
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。