Set-HybridConfiguration
이 cmdlet은 온-프레미스 Exchange에서만 제공됩니다.
Set-HybridConfiguration cmdlet을 사용하여 온-프레미스 Exchange organization 및 엔터프라이즈용 Microsoft 365의 Exchange Online 간의 하이브리드 배포를 수정합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Set-HybridConfiguration
[-ClientAccessServers <MultiValuedProperty>]
[-Confirm]
[-DomainController <Fqdn>]
[-Domains <MultiValuedProperty>]
[-EdgeTransportServers <MultiValuedProperty>]
[-ExternalIPAddresses <MultiValuedProperty>]
[-Features <MultiValuedProperty>]
[-Name <String>]
[-OnPremisesSmartHost <SmtpDomain>]
[-ReceivingTransportServers <MultiValuedProperty>]
[-SecureMailCertificateThumbprint <String>]
[-SendingTransportServers <MultiValuedProperty>]
[-ServiceInstance <Int32>]
[-TlsCertificateName <SmtpX509Identifier>]
[-TransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
Set-HybridConfiguration cmdlet은 보안 메일 사용, 하이브리드 기능을 위한 특정 사서함 서버 지정 또는 온-프레미스 Exchange와 Exchange Online 간의 약속 있음/없음 공유를 사용하거나 사용하지 않도록 설정하는 등의 하이브리드 구성 기능을 수정합니다.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Set-HybridConfiguration -SecureMailCertificateThumbprint AC00F35CBA8359953F4126E0984B5CCAFA2F4F17
Exchange Server 2010에서 이 예제에서는 하이브리드 구성에서 지문 AC00F35CBA8359953F4126E0984B5CCAFA2F4F17 인증서를 보안 메일 메시징용 인증서로 사용하도록 지정합니다.
예 2
Set-HybridConfiguration -Features OnlineArchive,MailTips,OWARedirection,FreeBusy,MessageTracking
이 예제에서는 보안 메일 및 중앙 집중식 전송 하이브리드 배포 기능을 사용하지 않도록 설정하지만 온-프레미스 Exchange와 Exchange Online 조직 간에 Exchange Online 아카이브, MailTips, 웹용 Outlook 리디렉션, 약속 있음/없음 및 메시지 추적 기능을 사용하도록 설정합니다.
예 3
Set-HybridConfiguration -TlsCertificateName "<I>CN=A. Datum Corporation CA-3, OU=www.adatum.com, O=A.Datum Corp, C=US<S>CN=mail.contoso.com, O=Barbara Zighetti, L=Seattle, S=WA, C=US"
이 예에서는 하이브리드 배포에서 정의된 TLS 인증서를 사용하도록 지정합니다. 이러한 인증서는 CA에서 발급한 X.509 인증서의 Issuer 및 Subject 특성의 조합으로 참조됩니다.
매개 변수
-ClientAccessServers
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
이 매개 변수는 Exchange Server 2010에서만 사용할 수 있습니다.
ClientAccessServers 매개 변수는 하이브리드 배포 기능을 지원하도록 구성된 Exchange Server 2010 SP2 이상의 허브 전송 서버를 지정합니다. TCP 포트 80 및 443의 인터넷에서 액세스할 수 있는 하나 이상의 클라이언트 액세스 서버를 지정해야 합니다. 서버는 다음 기능을 사용하도록 구성됩니다.
- MRS(사서함 복제 서비스) 프록시: MRS 프록시 서비스 구성을 사용하도록 설정합니다.
- 가상 디렉터리: EWS(Exchange Web Services), 오프라인 주소록 및 ActiveSync 서비스에 대한 기본 웹 사이트를 호스트합니다.
- Outlook Anywhere: 사용.
여러 서버를 쉼표로 구분하여 지정할 수 있습니다.
형식: | MultiValuedProperty |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Confirm
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false
를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-DomainController
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
형식: | Fqdn |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Domains
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Domains 매개 변수는 하이브리드 배포에 사용되는 도메인 네임스페이스를 지정합니다. 이러한 도메인은 온-프레미스 Exchange 또는 Exchange Online 허용된 도메인으로 구성해야 합니다. 이러한 도메인은 하이브리드 구성에 사용된 조직 관계와 송신 및 수신 커넥터를 구성하는 데 사용됩니다.
여러 개의 도메인을 쉼표로 구분하여 지정할 수 있습니다.
형식: | MultiValuedProperty |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-EdgeTransportServers
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
EdgeTransportServers 매개 변수는 하이브리드 배포 기능을 지원하도록 구성되는 Edge 전송 서버를 지정합니다. Edge 전송 서버는 외부에서 인터넷으로 포트 25를 통해 액세스할 수 있어야 합니다. EdgeTransportServers 매개 변수에 사용할 수 있는 값은 Edge 전송 서버의 전체 컴퓨터 이름 또는 짧은 컴퓨터 이름입니다(예: edge.corp.contoso.com 또는 EDGE). 두 개 이상의 Edge 전송 서버를 정의할 경우 쉼표로 서버 이름을 구분하세요.
EdgeTransportServers 매개 변수를 구성하는 경우 ReceivingTransportServers 및 SendingTransportServers 매개 변수 값을 $null로 구성해야 합니다.
형식: | MultiValuedProperty |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-ExternalIPAddresses
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
ExternalIPAddresses 매개 변수는 Microsoft Exchange Server 2010 Hub 전송 서버의 공개적으로 액세스할 수 있는 인바운드 IP 주소를 지정하는 레거시 매개 변수입니다.
이 매개 변수를 사용하여 레거시 Exchange 2010 Hub 전송 서버 IP 주소 값만 변경하거나 지워야 합니다. IPv6 주소는 지원되지 않습니다.
형식: | MultiValuedProperty |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Features
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Features 매개 변수는 하이브리드 구성에 사용할 수 있는 기능을 지정합니다. 유효한 값은 다음과 같습니다.
- OnlineArchive: 온-프레미스 Exchange 및 Exchange Online 사용자에 대해 Exchange Online 보관을 사용하도록 설정합니다.
- FreeBusy: 온-프레미스 Exchange와 Exchange Online 사용자 간에 일정 약속 있음/없음 공유를 사용하도록 설정합니다.
- MailTips: 온-프레미스 Exchange와 Exchange Online 사용자 간에 MailTips를 사용하도록 설정합니다.
- MessageTracking: 온-프레미스 Exchange와 Exchange Online 간에 메시지 추적을 사용하도록 설정합니다.
- OWARedirection: 사용자 사서함이 있는 위치에 따라 온-프레미스 Exchange 또는 Exchange Online 대한 자동 웹용 Outlook(이전의 Outlook Web App 또는 OWA라고도 함) 리디렉션을 사용하도록 설정합니다.
- SecureMail: 온-프레미스 Exchange와 Exchange Online 간에 TLS(전송 계층 보안)를 통해 보안 메시지 전송을 사용하도록 설정합니다.
- 중앙 집중식: 온-프레미스 Exchange 서버가 온-프레미스 Exchange와 Exchange Online 간의 모든 메시지 전송을 처리할 수 있도록 합니다. 여기에는 두 조직의 인터넷으로 메시지 배달이 포함됩니다. 이 값을 사용하지 않는 경우 온-프레미스 Exchange 및 Exchange Online 각각 자체 인터넷 메시지 배달을 담당합니다.
- 사진: 온-프레미스 Exchange와 Exchange Online 간에 사용자 사진 데이터를 공유할 수 있습니다. 이 기능은 하이브리드 배포의 OrganizationRelationship cmdlet에서 PhotosEnabled 매개 변수와 함께 작동합니다. 이 값을 사용하면 PhotosEnabled 매개 변수가 자동으로 $true 설정됩니다. 이 값을 사용하지 않으면 PhotosEnabled 매개 변수가 자동으로 $false 설정됩니다.
쉼표로 구분하여 여러 값을 지정할 수 있습니다. 하이브리드 구성 마법사를 사용하는 경우 모든 기능은 기본적으로 사용하도록 설정됩니다.
형식: | MultiValuedProperty |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-Name
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
이 매개 변수는 더 이상 사용되지 않으며 더 이상 사용되지 않습니다.
Exchange organization HybridConfiguration 개체는 하나만 있을 수 있습니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-OnPremisesSmartHost
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
OnPremisesSmartHost 매개 변수는 온-프레미스 Exchange와 Exchange Online 간의 보안 메일 전송에 사용되는 온-프레미스 Exchange 사서함 서버의 FQDN을 지정합니다.
형식: | SmtpDomain |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-ReceivingTransportServers
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
ReceivingTransportServers 매개 변수는 Exchange Online 아웃바운드 커넥터 구성에 정의된 사서함 서버를 지정합니다. 유효한 값은 다음과 같습니다.
- 사서함 서버 FQDN(예: mbx.corp.contoso.com)입니다.
- 사서함 서버 호스트 이름(예: MBX)입니다.
쉼표로 지정된 여러 서버를 지정할 수 있습니다.
지정된 서버는 하이브리드 배포에서 Exchange Online 온-프레미스 Exchange로 보안 전자 메일 메시지를 받습니다. 보안 메일을 사용하려면 공개적으로 액세스할 수 있는 사서함 서버를 하나 이상 지정해야 합니다.
EdgeTransportServers 매개 변수를 사용하는 경우 이 매개 변수의 값은 비어 있어야 합니다($null).
형식: | MultiValuedProperty |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-SecureMailCertificateThumbprint
적용 가능: Exchange Server 2010
이 매개 변수는 Exchange Server 2010에서만 사용할 수 있습니다.
SecureMailCertificateThumbprint 매개 변수는 하이브리드 배포 보안 메시지 전송을 위한 인증서로 사용할 X.509 인증서의 지문을 지정합니다. 이 인증서는 자체 서명할 수 없으며 신뢰할 수 있는 CA(인증 기관)에서 가져와야 하며 TransportServers 매개 변수에 정의된 모든 허브 전송 서버에 설치해야 합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-SendingTransportServers
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
SendTransportServers 매개 변수는 Exchange Online 인바운드 커넥터 구성에 정의된 사서함 서버를 지정합니다. 유효한 값은 다음과 같습니다.
- 사서함 서버 FQDN(예: mbx.corp.contoso.com)입니다.
- 사서함 서버 호스트 이름(예: MBX)입니다.
쉼표로 지정된 여러 서버를 지정할 수 있습니다.
지정된 서버는 온-프레미스 Exchange에서 보안 전자 메일 메시지를 전송하여 하이브리드 배포에서 Exchange Online. 보안 메일을 사용하려면 공개적으로 액세스할 수 있는 사서함 서버를 하나 이상 지정해야 합니다.
EdgeTransportServers 매개 변수를 사용하는 경우 이 매개 변수의 값은 비어 있어야 합니다($null).
형식: | MultiValuedProperty |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-ServiceInstance
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
이 매개 변수는 중국의 21Vianet에서 작동하는 Office 365 의미 있습니다.
중국에서 21Vianet에서 작동하는 Office 365 하이브리드 배포를 수동으로 구성하려면 이 매개 변수의 값을 1로 설정합니다. 그렇지 않으면 기본값은 0입니다.
다른 모든 Microsoft 365 조직은 하이브리드 구성 마법사를 사용하여 하이브리드 배포를 구성해야 합니다.
형식: | Int32 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-TlsCertificateName
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
TlsCertificateName 매개 변수는 TLS 암호화에 사용할 X.509 인증서를 지정합니다. 이 매개 변수에 대한 유효한 구문은 입니다 "<I>X.500Issuer<S>X.500Subject"
.
-
X.500Issuer
: 인증서 발급자 필드의 값입니다. -
X.500Subject
: 인증서의 주체 필드에 있는 값입니다.
Get-ExchangeCertificate cmdlet을 실행하여 이러한 값을 찾을 수 있습니다.
또는 Get-ExchangeCertificate 실행하여 인증서의 지문 값을 찾은 후 명령에서 지문 값을 사용하고 명령을 $TLSCert = Get-ExchangeCertificate -Thumbprint <Thumbprint>
$TLSCertName = "<I>$($TLSCert.Issuer)<S>$($TLSCert.Subject)"
실행한 다음 이 매개 변수의 값을 $TLSCertName
사용합니다.
형식: | SmtpX509Identifier |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-TransportServers
적용 가능: Exchange Server 2010
이 매개 변수는 Exchange Server 2010에서만 사용할 수 있습니다.
TransportServers 매개 변수는 하이브리드 배포 기능을 지원하도록 구성된 Exchange Server 2010 SP2 이상의 허브 전송 서버를 지정합니다.
온-프레미스 Exchange와 Exchange Online 간의 보안 메일을 위해 인터넷에서 액세스할 수 있는 허브 전송 서버를 하나 이상 지정해야 합니다.
여러 서버를 쉼표로 구분하여 지정할 수 있습니다.
형식: | MultiValuedProperty |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
-WhatIf
적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.