Set-MigrationEndpoint

모듈:

ExchangePowerShell

적용 대상:

Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.

Set-MigrationEndpoint cmdlet을 사용하여 단독형 또는 준비된 Exchange 마이그레이션, IMAP 마이그레이션, Google 작업 영역(이전의 G Suite) 마이그레이션 및 원격 이동에 대한 설정을 편집합니다.

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

Syntax

Set-MigrationEndpoint
   [-Identity] <MigrationEndpointIdParameter>
   [-AcceptUntrustedCertificates <Boolean>]
   [-ApplicationId <String>]
   [-AppSecretKeyVaultUrl <String>]
   [-Authentication <AuthenticationMethod>]
   [-Confirm]
   [-Credentials <PSCredential>]
   [-DomainController <Fqdn>]
   [-ExchangeServer <String>]
   [-MailboxPermission <MigrationMailboxPermission>]
   [-MaxConcurrentIncrementalSyncs <Unlimited>]
   [-MaxConcurrentMigrations <Unlimited>]
   [-NspiServer <String>]
   [-Partition <MailboxIdParameter>]
   [-Port <Int32>]
   [-PublicFolderDatabaseServerLegacyDN <String>]
   [-RemoteServer <Fqdn>]
   [-RpcProxyServer <Fqdn>]
   [-Security <IMAPSecurityMechanism>]
   [-ServiceAccountKeyFileData <Byte[]>]
   [-SkipVerification]
   [-SourceMailboxLegacyDN <String>]
   [-TestMailbox <MailboxIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Description

Set-MigrationEndpoint cmdlet을 사용하여 서로 다른 유형의 마이그레이션에 대한 설정을 구성합니다.

• 포리스트 간 이동: 서로 다른 두 온-프레미스 Exchange 포리스트 간에 사서함을 이동합니다. 포리스트 간 이동에는 RemoteMove 엔드포인트를 사용해야 합니다.
• 원격 이동: 하이브리드 배포에서 원격 이동에는 온보딩 또는 오프보딩 마이그레이션이 포함됩니다. 원격 이동에서는 RemoteMove 끝점을 사용해야 합니다. 온보딩은 온-프레미스 Exchange 조직에서 Exchange Online 사서함을 이동하고 RemoteMove 엔드포인트를 마이그레이션 일괄 처리의 원본 엔드포인트로 사용합니다. 오프보딩은 사서함을 Exchange Online 온-프레미스 Exchange 조직으로 이동하고 RemoteMove 엔드포인트를 마이그레이션 일괄 처리의 대상 엔드포인트로 사용합니다.
• 단독형 Exchange 마이그레이션: 온-프레미스 Exchange 조직의 모든 사서함을 Exchange Online 마이그레이션합니다. Exchange 마이그레이션을 중단하려면 Exchange 엔드포인트를 사용해야 합니다.
• 준비된 Exchange 마이그레이션: 온-프레미스 Exchange 조직에서 Exchange Online 사서함의 하위 집합을 마이그레이션합니다. 준비된 Exchange 마이그레이션을 사용하려면 Exchange 엔드포인트를 사용해야 합니다.
• IMAP 마이그레이션: 온-프레미스 Exchange 조직 또는 기타 전자 메일 시스템에서 Exchange Online 사서함 데이터를 마이그레이션합니다. IMAP 마이그레이션의 경우 사서함 데이터를 마이그레이션하기 전에 먼저 클라우드 기반의 사서함을 만들어야 합니다. IMAP 마이그레이션에서는 IMAP 끝점을 사용해야 합니다.
• Gmail 마이그레이션: Google Workspace 테넌트에서 Exchange Online 사서함 데이터 마이그레이션 Google Workspace 마이그레이션의 경우 사서함 데이터를 마이그레이션하기 전에 먼저 클라우드 기반 메일 사용자 또는 사서함을 만들어야 합니다. Google Workspace 마이그레이션에는 Gmail 엔드포인트를 사용해야 합니다.
• 로컬: 단일 온-프레미스 Exchange 포리스트 내에서 서로 다른 서버 또는 데이터베이스 간에 사서함을 이동합니다. 로컬 이동에서는 끝점을 사용할 필요가 없습니다.

다른 이동 및 마이그레이션 시나리오에 대한 자세한 내용은 다음을 참조하십시오.

• 사서함이 Exchange Server 이동합니다.
• Exchange Server 온-프레미스 사서함 이동 관리

일괄 처리 내의 개별 사용자에게 영향을 주는 엔드포인트에 대한 변경 내용은 다음에 일괄 처리될 때부터 적용됩니다. 클라우드 기반 서비스에서 이 cmdlet을 실행하고 이러한 설정의 애플리케이션 속도를 높이려면 -Update 매개 변수를 사용하여 Set-MigrationBatch cmdlet을 실행하는 것이 좋습니다.

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

예제

예 1

Set-MigrationEndpoint -Identity CutoverExchangeEndpoint01 -MaxConcurrentIncrementalSyncs 50 -NspiServer Server01.contoso.com

이 예에서는 NSPI 서버 Server01을 사용하는 CutoverExchangeEndpoint01 마이그레이션 끝점에서 MaxConcurrentIncrementalSyncs 설정을 50으로 변경합니다.

예 2

Set-MigrationEndpoint -Identity Onboardingmigrationendpoint01 -MaxConcurrentMigrations 10 -RemoteServer Server01.contoso.com

이 예에서는 원격 서버 Server01을 사용하는 Onboardingmigrationendpoint01 마이그레이션 끝점에서 MaxConcurrentMigrations 설정을 10으로 변경합니다.

매개 변수

-AcceptUntrustedCertificates

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

{{ Fill AcceptUntrustedCertificates Description }}

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ApplicationId

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

{{ Fill ApplicationId description }}

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-AppSecretKeyVaultUrl

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

{{ Fill AppSecretKeyVaultUrl Description }}

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Authentication

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

Authentication 매개 변수는 원격 메일 서버에서 사용하는 인증 방법을 지정합니다.

Type:	AuthenticationMethod
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Credentials

Credentials 매개 변수는 원격 엔드포인트에 연결하기 위한 사용자 이름과 암호를 지정합니다. 스테이징 또는 컷오버 Exchange 엔드포인트 또는 RemoteMove 엔드포인트를 만들 때 자격 증명을 사용해야 합니다.

이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ExchangeServer

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

ExchangeServer 매개 변수는 단독형 및 단계적 마이그레이션을 위해 온-프레미스 원본 Exchange 서버를 지정합니다. 이 매개 변수는 자동 검색을 사용하지 않는 스테이징 및 컷오버 Exchange 엔드포인트에만 적용됩니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Identity

Identity 매개 변수는 구성할 마이그레이션 끝점의 이름을 지정합니다.

Type:	MigrationEndpointIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MailboxPermission

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

MailboxPermission 매개 변수는 OutlookAnywhere 온보딩(미리 구성된 Exchange 마이그레이션 및 단독형 Exchange 마이그레이션) 중 원본 사서함에 액세스하기 위해 사용해야 하는 권한을 지정합니다. OutlookAnywhere 이외의 마이그레이션에는 이 매개 변수가 사용되지 않습니다.

지정한 계정에는 다음 권한이 있어야 합니다.

• FullAccess 권한. 계정에 마이그레이션하려는 사서함에 대한 모든 권한이 있습니다.
• Admin 권한. 계정이 마이그레이션하려는 모든 사서함에 액세스할 수 있는 도메인 관리자입니다.

Type:	MigrationMailboxPermission
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-MaxConcurrentIncrementalSyncs

MaxConcurrentIncrementalSyncs 매개 변수는 특정 시점에 이 끝점에 대해 허용된 최대 증분 동기화 수를 지정합니다. 이 값은 MaxConcurrentMigrations 매개 변수보다 작거나 같아야 합니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-MaxConcurrentMigrations

MaxConcurrentMigrations 매개 변수는 특정 시점에 이 끝점에 대해 마이그레이션될 최대 사서함 수를 지정합니다. 이 매개 변수는 모든 마이그레이션 유형에 적용할 수 있습니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-NspiServer

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

NspiServer 매개 변수는 원격 NSPI(Name Service Provider Interface) 서버의 FQDN을 지정합니다. 이 매개 변수는 자동 검색을 사용하지 않는 스테이징 및 컷오버 Exchange 엔드포인트에만 적용됩니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Partition

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Port

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

IMAP 마이그레이션에서 Port 매개 변수는 마이그레이션 프로세스에서 원격 서버에 연결하는 데 사용하는 TCP 포트 번호를 지정합니다.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-PublicFolderDatabaseServerLegacyDN

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-RemoteServer

RemoteServer 매개 변수는 이동에 대한 프로토콜 유형에 따라 원격 서버를 지정합니다.

• Exchange 서버 이동: 클라이언트 액세스 역할이 설치된 Exchange 서버의 FQDN, 클라이언트 액세스 서버 배열 또는 지원되는 네트워크 부하 분산 장치 뒤에 있는 클라이언트 액세스 서버 그룹입니다.
• IMAP 이동: IMAP 서버의 FQDN입니다.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-RpcProxyServer

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

준비된 Exchange 마이그레이션의 경우 RpcProxyServer 매개 변수는 온-프레미스 Exchange 서버에 대한 RPC 프록시 서버의 FQDN을 지정합니다. 이 매개 변수는 자동 검색을 사용하지 않는 스테이징 및 컷오버 Exchange 엔드포인트에만 적용됩니다.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-Security

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

IMAP 마이그레이션의 경우 Security 매개 변수는 원격 메일 서버에서 사용하는 암호화 방법을 지정합니다. 옵션은 None, Tls 또는 Ssl입니다.

Type:	IMAPSecurityMechanism
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ServiceAccountKeyFileData

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

ServiceAccountKeyFileData 매개 변수는 서비스 계정으로 인증하는 데 필요한 정보를 지정하는 데 사용됩니다. 데이터는 원격 테넌트 액세스 권한이 부여된 서비스 계정을 만들 때 다운로드되는 JSON 키 파일에서 가져옵니다.

이 매개 변수에 유효한 값을 사용하려면 다음 구문을 ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))사용하여 바이트 인코딩된 개체로 파일을 읽어야 합니다. 이 명령을 매개 변수 값으로 사용하거나 변수($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>'))에 출력을 쓰고 변수를 매개 변수 값($data)으로 사용할 수 있습니다.

Type:	Byte[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-SkipVerification

SkipVerification 스위치는 마이그레이션 엔드포인트를 만들 때 원격 서버에 연결할 수 있는지 확인하는 것을 건너뜁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-SourceMailboxLegacyDN

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

SourceMailboxLegacyDN 매개 변수는 대상 서버에서 사서함을 지정합니다. 온-프레미스 테스트 사서함의 LegacyExchangeDN을 이 매개 변수 값으로 사용합니다. 이 cmdlet은 대상 서버에 있는 관리자 계정의 자격 증명을 사용하여 이 사서함에 액세스합니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-TestMailbox

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

TestMailbox 매개 변수는 대상 서버에서 사서함을 지정합니다. 이 매개 변수에 대한 값으로 기본 SMTP 주소를 사용합니다. 이 cmdlet은 대상 서버에 있는 관리자 계정의 자격 증명을 사용하여 이 사서함에 액세스합니다.

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

입력

Input types

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

출력

Output types

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