Set-OutboundConnector

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Online, Exchange Online Protection

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

Set-OutboundConnector cmdlet을 사용하여 클라우드 기반 조직의 기존 아웃바운드 커넥터를 수정할 수 있습니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

Syntax

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>]

Description

아웃바운드 커넥터는 특정 구성 옵션이 필요한 원격 도메인으로 전자 메일 메시지를 보냅니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Set-OutboundConnector "Contoso Outbound Connector" -UseMxRecord $false -SmartHosts 192.168.0.1

이 예에서는 IP 주소 192.168.0.1에 있는 스마트 호스트로 라우팅할 Contoso Outbound Connector라는 기존 아웃바운드 커넥터의 설정을 변경합니다.

매개 변수

-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 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

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 cmdlet에서 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 cmdlet을 사용하여 커넥터의 유효성을 검사합니다.

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 cmdlet을 사용하여 커넥터의 유효성을 검사합니다.

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 예제와 같이 지정된 도메인의 모든 하위 도메인을 지정할 수 있습니다. 그러나 다음 예와 같은 방법으로 와일드카드 문자를 포함할 수는 없습니다.

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(클래스리스 InterDomain 라우팅) 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: 커넥터는 하나 이상의 스마트 호스트에 전자 메일을 배달합니다. 이 설정에는 SmartHosts 값에 대해 하나 이상의 스마트 호스트가 필요합니다.

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

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

출력

Output types

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.

Set-OutboundConnector

Syntax

Description

예제

예 1

매개 변수

-AllAcceptedDomains

-CloudServicesMailEnabled

-Comment

-Confirm

-ConnectorSource

-ConnectorType

-Enabled

-Identity

-IsTransportRuleScoped

-IsValidated

-LastValidationTimestamp

-Name

-RecipientDomains

-RouteAllMessagesViaOnPremises

-SenderRewritingEnabled

-SmartHosts

-TestMode

-TlsDomain

-TlsSettings

-UseMXRecord

-ValidationRecipients

-WhatIf

입력

출력

피드백

피드백

추가 리소스