New-InboundConnector

구문

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

Description

예제

예 1

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

예 2

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

매개 변수

-AssociatedAcceptedDomains

적용 가능: Exchange Online, Exchange Online Protection

ASSOCIATedAcceptedDomains 매개 변수는 커넥터를 사용하는 원본 도메인을 지정된 허용 도메인으로 제한합니다. 유효한 값은 Microsoft 365 organization 허용된 도메인으로 구성된 SMTP 도메인입니다.

쉼표로 구분하여 여러 값을 지정할 수 있습니다.

매개 변수 속성

매개 변수 집합

-ClientHostNames

적용 가능: Exchange Online, Exchange Online Protection

{{ Fill ClientHostNames description }}

매개 변수 속성

매개 변수 집합

-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: 커넥터는 하이브리드 조직의 메일 흐름에 사용되지 않으므로 커넥터를 통해 흐르는 메시지에서 프레미스 간 헤더가 제거됩니다.

매개 변수 속성

매개 변수 집합

-Comment

적용 가능: Exchange Online, Exchange Online Protection

Comment 매개 변수는 설명(선택 사항)을 지정합니다. 공백이 포함된 값을 지정하는 경우 값을 큰따옴표(")로 묶어야 합니다(예: “이는 관리자 정보입니다”).

매개 변수 속성

매개 변수 집합

-Confirm

적용 가능: Exchange Online, Exchange Online Protection

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

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

매개 변수 속성

매개 변수 집합

-ConnectorSource

적용 가능: Exchange Online, Exchange Online Protection

ConnectorSource 매개 변수는 커넥터를 만드는 방법을 지정합니다. 이 매개 변수에는 다음과 같은 값을 입력할 수 있습니다.

• Default: 커넥터가 수동으로 만들어졌습니다. 이 값은 기본값입니다.
• HybridWizard: 커넥터는 하이브리드 구성 마법사에서 자동으로 만들어집니다.
• Migrated: 커넥터가 Microsoft Forefront Online Protection for Exchange에서 만들어졌습니다.

이 값은 변경하지 않는 것이 좋습니다.

매개 변수 속성

매개 변수 집합

-ConnectorType

적용 가능: Exchange Online, Exchange Online Protection

ConnectorType 매개 변수는 커넥터가 메시지를 허용하는 원본 도메인의 범주를 지정합니다. 유효한 값은 다음과 같습니다.

• 파트너: 외부 파트너 또는 서비스.
• OnPremises: 커넥터가 온-프레미스 조직에서 사용하는 도메인에 서비스를 제공합니다. OnPremises 커넥터는 커넥터 및 추가 요구 사항과 일치하는 전자 메일에 특별한 권한을 부여합니다. 예를 들어 테넌트에서 인터넷 대상으로 릴레이를 허용하거나, 온-프레미스 또는 다른 환경에서 내부(하이브리드 구성)로 전자 메일을 승격하거나, 더 복잡한 다른 메일 흐름을 사용하도록 설정합니다.

매개 변수 속성

매개 변수 집합

-EFSkipIPs

적용 가능: Exchange Online, Exchange Online Protection

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.

쉼표로 구분하여 여러 값을 지정할 수 있습니다.

매개 변수 속성

매개 변수 집합

-EFSkipLastIP

적용 가능: Exchange Online, Exchange Online Protection

EFSkipIPs 매개 변수는 커넥터에 대한 향상된 필터링의 동작을 지정합니다. 유효한 값은 다음과 같습니다.

• $true: 마지막 메시지 원본만 건너뜁 있습니다.
• $false: EFSkipIPs 매개 변수로 지정된 원본 IP 주소를 건너뜁니다. IP 주소를 지정하지 않으면 커넥터에서 커넥터에 대한 향상된 필터링이 비활성화됩니다. 이 값은 기본값입니다.

매개 변수 속성

매개 변수 집합

-EFSkipMailGateway

적용 가능: Exchange Online, Exchange Online Protection

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

매개 변수 집합

-EFTestMode

적용 가능: Exchange Online, Exchange Online Protection

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

매개 변수 집합

-EFUsers

적용 가능: Exchange Online, Exchange Online Protection

EFUsers 매개 변수는 커넥터에 대한 고급 필터링이 적용되는 받는 사람을 지정합니다. 기본값은 비어 있는($null) 커넥터에 대한 향상된 필터링이 모든 받는 사람에게 적용됨을 의미합니다.

받는 사람 전자 메일 주소가 여러 개인 경우 각 주소를 쉼표로 구분하여 지정할 수 있습니다.

매개 변수 속성

매개 변수 집합

-Enabled

적용 가능: Exchange Online, Exchange Online Protection

Enabled 매개 변수는 커넥터를 사용하거나 사용하지 않도록 설정합니다. 유효한 값은 다음과 같습니다.

• $true: 커넥터를 사용할 수 있습니다. 이 값은 기본값입니다.
• $false: 커넥터를 사용할 수 없습니다.

매개 변수 속성

매개 변수 집합

-Name

적용 가능: Exchange Online, Exchange Online Protection

Name 매개 변수는 커넥터를 설명하는 이름을 지정합니다.

매개 변수 속성

매개 변수 집합

-RequireTls

적용 가능: Exchange Online, Exchange Online Protection

RequireTLS 매개 변수는 파트너 유형 커넥터에서 수신하는 모든 메시지에 대해 TLS 전송을 요구할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

• $true: TLS를 통해 전송되지 않으면 메시지를 거부합니다. 이 값은 기본값입니다.
• $false: TLS를 통해 메시지를 보내지 않는 경우 메시지를 허용합니다.

참고: 이 매개 변수는 파트너 유형 커넥터에만 적용됩니다.

매개 변수 속성

매개 변수 집합

-RestrictDomainsToCertificate

적용 가능: Exchange Online, Exchange Online Protection

RestrictDomainsToCertificate 매개 변수는 메시지가 파트너 유형 커넥터를 사용하기 전에 TLS 인증서의 Subject 값을 검사할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

• $true: 원본 전자 메일 서버가 인증하는 데 사용하는 TLS 인증서의 Subject 값이 TlsSenderCertificateName 매개 변수 값과 일치하는 경우에만 메일에서 커넥터를 사용할 수 있습니다.
• $false: 원본 전자 메일 서버가 인증하는 데 사용하는 TLS 인증서의 주체 값은 해당 원본의 메일이 커넥터를 사용하는지 여부를 제어하지 않습니다. 이 값은 기본값입니다.

참고: 이 매개 변수는 파트너 유형 커넥터에만 적용됩니다.

매개 변수 속성

매개 변수 집합

-RestrictDomainsToIPAddresses

적용 가능: Exchange Online, Exchange Online Protection

RestrictDomainsToIPAddresses 매개 변수는 파트너 유형 커넥터에 대한 알 수 없는 원본 IP 주소에서 가져온 메일을 거부할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

• $true: 원본 IP 주소가 SenderIPAddress 매개 변수로도 지정되지 않은 경우 SenderDomains 매개 변수로 지정된 도메인의 메일을 자동으로 거부합니다.
• $false: 원본 IP 주소를 기반으로 SenderDomains 매개 변수에 지정된 도메인의 메일을 자동으로 거부하지 마세요. 이 값은 기본값입니다.

참고: 이 매개 변수는 파트너 유형 커넥터에만 적용됩니다.

매개 변수 속성

매개 변수 집합

-ScanAndDropRecipients

적용 가능: Exchange Online, Exchange Online Protection

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

매개 변수 속성

매개 변수 집합

-SenderDomains

적용 가능: Exchange Online, Exchange Online Protection

SenderDomains 매개 변수는 파트너 형식 커넥터가 메시지를 수락하는 원본 도메인을 지정합니다(파트너 형식 커넥터의 scope 제한). 유효한 값은 SMTP 도메인입니다. 와일드카드는 도메인 및 모든 하위 도메인(예: *.contoso.com)을 나타내기 위해 지원됩니다. 그러나 와일드카드 문자를 포함할 수 없습니다(예 ___domain.*.contoso.com : 유효하지 않음).

여러 개의 도메인을 쉼표로 구분하여 지정할 수 있습니다.

매개 변수 속성

매개 변수 집합

-SenderIPAddresses

적용 가능: Exchange Online, Exchange Online Protection

SenderIPAddresses 매개 변수는 RestrictDomainsToIPAddresses 매개 변수의 값이 $true 때 파트너 형식 커넥터가 메시지를 수락하는 원본 IPV4 IP 주소를 지정합니다. 유효한 값은 다음과 같습니다.

• 단일 IP 주소: 예: 192.168.1.1.
• CIDR(Classless InterDomain Routing) IP 주소 범위(예: 192.168.0.1/25) 유효한 서브넷 마스크 값은 /24~/32입니다.

IP 주소가 여러 개인 경우 각 주소를 쉼표로 구분하여 지정할 수 있습니다.

IPv6 주소는 지원되지 않습니다.

참고: 이 매개 변수는 RestrictDomainsToIPAddresses 매개 변수의 값이 $true 경우에만 파트너 형식 커넥터에 적용됩니다.

매개 변수 속성

매개 변수 집합

-TlsSenderCertificateName

적용 가능: Exchange Online, Exchange Online Protection

TlsSenderCertificateName 매개 변수는 RequireTls 매개 변수의 값이 $true 때 사용되는 TLS 인증서를 지정합니다. 유효한 값은 SMTP 도메인입니다. 와일드카드는 도메인 및 모든 하위 도메인(예: *.contoso.com)을 나타내기 위해 지원되지만 와일드카드 문자를 포함할 수는 없습니다(예: ___domain.*.contoso.com 유효하지 않음).

매개 변수 속성

매개 변수 집합

-TreatMessagesAsInternal

적용 가능: Exchange Online, Exchange Online Protection

TreatMessagesAsInternal 매개 변수는 온-프레미스 organization 보낸 메시지를 내부 메시지로 식별하는 대체 메서드를 지정합니다. 온-프레미스 organization Exchange를 사용하지 않는 경우에만 이 매개 변수를 사용하는 것이 좋습니다. 유효한 값은 다음과 같습니다.

• $true: 보낸 사람의 도메인이 Microsoft 365에 구성된 도메인과 일치하는 경우 메시지는 내부로 간주됩니다. 이 설정을 사용하면 2010년 이상 Exchange Server 설치되지 않은 Microsoft 365 조직과 온-프레미스 조직 간의 내부 메일 흐름을 허용합니다. 그러나 이 설정에는 잠재적인 보안 위험(예: 내부 메시지 바이패스 안티스팜 필터링)이 있으므로 이 설정을 구성할 때는 주의해야 합니다.
• $false: 메시지는 내부로 간주되지 않습니다. 이 값은 기본값입니다.

하이브리드 환경에서는 하이브리드 구성 마법사가 Microsoft 365의 인바운드 커넥터 및 온-프레미스 Exchange organization 송신 커넥터(CloudServicesMailEnabled 매개 변수)에서 필요한 설정을 자동으로 구성하기 때문에 이 매개 변수를 사용할 필요가 없습니다.

참고: 다음 조건 중 하나가 true인 경우 이 매개 변수를 값 $true 설정할 수 없습니다.

• CloudServicesMailEnabled 매개 변수는 $true 값으로 설정됩니다.
• ConnectorType 매개 변수 값은 OnPremises가 아닙니다.

매개 변수 속성

매개 변수 집합

-TrustedOrganizations

적용 가능: Exchange Online, Exchange Online Protection

TrustedOrganizations 매개 변수는 신뢰할 수 있는 메일 원본(예: 인수 및 합병 후)인 다른 Microsoft 365 조직을 지정합니다. 여러 Microsoft 365 조직을 쉼표로 구분하여 지정할 수 있습니다.

이 매개 변수는 두 Microsoft 365 조직 간의 메일 흐름에만 작동하므로 다른 매개 변수는 사용되지 않습니다.

매개 변수 속성

매개 변수 집합

-WhatIf

적용 가능: Exchange Online, Exchange Online Protection

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

매개 변수 집합

CommonParameters

입력

Input types

출력

Output types