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