다음을 통해 공유


New-InboundConnector

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

New-InboundConnector cmdlet을 사용하여 클라우드 기반 조직에서 새 인바운드 커넥터를 만들 수 있습니다.

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

Syntax

New-InboundConnector
   [-Name] <String>
   -SenderDomains <MultiValuedProperty>
   [-AssociatedAcceptedDomains <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

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

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

예제

예 1

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

이 예에서는 다음 속성을 사용하여 Contoso Inbound Connector라는 인바운드 커넥터를 만듭니다.

  • 이 커넥터는 contoso.com 도메인 및 모든 하위 도메인에서 들어오는 연결을 수신합니다.
  • contoso.com 및 IP 범위 192.168.0.1/25에서만 메일을 허용합니다. 다른 IP 주소에서 시작된 경우 contoso.com 메일을 거부합니다.

예 2

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

이 예에서는 Contoso Inbound Secure Connector라는 인바운드 커넥터를 만들고 모든 메시지에 대해 TLS 전송을 사용해야 합니다.

매개 변수

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

  • 파트너: 외부 파트너 또는 서비스.
  • OnPremises: 온-프레미스 전자 메일 organization. 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

-Name

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

Type:String
Position:1
Default value:None
Required:True
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:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection

-SenderIPAddresses

SenderIPAddresses 매개 변수는 커넥터가 메시지를 수락하는 원본 IPV4 IP 주소를 지정합니다. 유효한 값은 다음과 같습니다.

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

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

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

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 조직을 쉼표로 구분하여 지정할 수 있습니다.

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

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은 데이터를 반환하지 않습니다.