Set-InboundConnector

참조

모듈:: ExchangePowerShell

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

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

Set-InboundConnector cmdlet을 사용하여 클라우드 기반 organization 기존 인바운드 커넥터를 변경합니다.

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

Syntax

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

Description

인바운드 커넥터는 특정 구성 옵션이 필요한 원격 도메인의 전자 메일 메시지를 수락합니다.

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

예제

예 1

Set-InboundConnector "Contoso Inbound Connector" -RequireTls $true -TlsSenderCertificateName contoso.com

이 예제에서는 Contoso.com 인바운드 커넥터라는 기존 인바운드 커넥터에 대해 다음과 같은 구성을 변경합니다.

커넥터에서 들어오는 모든 메시지에 대해 TLS 전송이 필요합니다.

통신을 암호화하는 데 사용되는 TLS 인증서에 도메인 이름 contoso.com

매개 변수

-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 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 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: 커넥터가 온-프레미스 조직에서 사용하는 도메인에 서비스를 제공합니다. 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

EFSkipLastIP 매개 변수 값이 $false 경우 커넥터에 대한 고급 필터링에서 건너뛸 원본 IP 주소를 EFSkipIPs 매개 변수로 지정합니다. 유효한 값은 다음과 같습니다.

단일 IP 주소: 예: 192.168.1.1.
IP 주소 범위: 예를 들어 192.168.0.1-192.168.0.254입니다.
CIDR(클래스리스 InterDomain 라우팅) 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: EFSkipIPs 매개 변수로 지정된 원본 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 인증서의 Subject 값을 검사할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

$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(클래스리스 InterDomain 라우팅) 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년 이상 Exchange Server 설치되지 않은 Microsoft 365 조직과 온-프레미스 조직 간의 내부 메일 흐름을 허용합니다. 그러나 이 설정에는 잠재적인 보안 위험(예: 내부 메시지 바이패스 안티스팜 필터링)이 있으므로 이 설정을 구성할 때는 주의해야 합니다.
$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 조직을 지정합니다. 이 매개 변수는 두 Microsoft 365 조직 간의 메일 흐름에만 작동하므로 다른 매개 변수는 사용되지 않습니다.

여러 값을 입력하고 기존 항목을 덮어쓰려면 다음 구문을 Value1,Value2,...ValueN사용합니다. 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.

기존 항목에 영향을 주지 않고 하나 이상의 값을 추가하거나 제거하려면 다음 구문을 @{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

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

출력

Output types

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

다음을 통해 공유

Set-InboundConnector

Syntax

Description

예제

예 1

매개 변수

-AssociatedAcceptedDomains

-CloudServicesMailEnabled

-Comment

-Confirm

-ConnectorSource

-ConnectorType

-EFSkipIPs

-EFSkipLastIP

-EFSkipMailGateway

-EFTestMode

-EFUsers

-Enabled

-Identity

-Name

-RequireTls

-RestrictDomainsToCertificate

-RestrictDomainsToIPAddresses

-ScanAndDropRecipients

-SenderDomains

-SenderIPAddresses

-TlsSenderCertificateName

-TreatMessagesAsInternal

-TrustedOrganizations

-WhatIf

입력

출력

피드백

추가 리소스