다음을 통해 공유

Complete-MigrationBatch

모듈:
Exchange PowerShell

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

Complete-MigrationBatch cmdlet을 사용하면 초기 동기화를 성공적으로 완료한 로컬 이동, 포리스트 간 이동 또는 원격 이동 마이그레이션에 대한 마이그레이션 일괄 처리를 완료할 수 있습니다.

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

구문

Default (기본값) 

Complete-MigrationBatch
    [[-Identity] <MigrationBatchIdParameter>]
    [-CompletePublicFolderMigrationWithDataLoss]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-NotificationEmails <MultiValuedProperty>]
    [-Partition <MailboxIdParameter>]
    [-SyncAndComplete]
    [-WhatIf]
    [<CommonParameters>]

Description

로컬 또는 포리스트 간 이동에 대한 마이그레이션 일괄 처리가 성공적으로 실행된 후 "동기화됨" 상태인 경우 Complete-MigrationBatch cmdlet을 사용하여 마이그레이션 일괄 처리를 완료합니다. 완료는 로컬 또는 포리스트 간 이동 중에 수행되는 마지막 단계입니다. 마이그레이션 일괄 처리를 완료하는 경우 cmdlet은 마이그레이션 일괄 처리에 포함된 각 사서함에 대해 다음과 같은 작업을 수행합니다.

  • 최종 증분 동기화를 실행합니다.
  • 새 대상 도메인을 가리키도록 사용자의 Microsoft Outlook 프로필을 구성합니다.
  • 원본 사서함을 원본 도메인에 있는 메일 사용 가능 사용자로 변환합니다.

클라우드 기반 서비스에서 이 cmdlet은 CompleteAfter 값을 현재 시간으로 설정합니다. 일괄 처리 내의 개별 사용자에게 적용된 CompleteAfter 설정은 일괄 처리의 설정을 재정의하므로 일부 사용자의 완료는 구성된 시간까지 지연될 수 있습니다.

완료 프로세스가 완료되면 Remove-MigrationBatch cmdlet을 사용하여 일괄 처리를 제거할 수 있습니다.

마이그레이션 일괄 처리에 오류와 함께 완료됨 상태 있는 경우 실패한 사용자를 다시 완료할 수 있습니다. Exchange Online Start-MigrationBatch cmdlet을 사용하여 실패한 사용자에 대한 마이그레이션을 다시 시도합니다. Exchange 2013 또는 Exchange 2016에서 Complete-MigrationBatch 사용하여 이러한 실패한 사용자를 다시 시도합니다.

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

예제

예 1

Complete-MigrationBatch -Identity LocalMove1 -NotificationEmails admin@contoso.com,lucio@contoso.com

이 예에서는 LocalMove1이라는 마이그레이션 일괄 처리를 완료하고 지정된 사용자에게 알림 전자 메일 메시지를 보냅니다.

매개 변수

-CompletePublicFolderMigrationWithDataLoss

적용 가능: Exchange Online

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

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

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

이 cmdlet에는 기본 제공 일시 중지가 있으므로 을 사용하여 -Confirm:$false 확인을 건너뜁니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-DomainController

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

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

매개 변수 속성

형식:Fqdn
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Identity

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Identity 매개 변수는 완료하려는 마이그레이션 일괄 처리의 이름을 지정합니다. 이 매개 변수의 값은 New-MigrationBatch cmdlet의 Name 매개 변수로 지정됩니다. Get-MigrationBatch cmdlet을 사용하여 마이그레이션 일괄 처리에 대한 이 매개 변수의 값을 결정합니다.

매개 변수 속성

형식:MigrationBatchIdParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:1
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-NotificationEmails

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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

NotificationEmails 매개 변수는 마이그레이션 일괄 처리가 완료된 후 상태 보고서가 전송되는 대상 전자 메일 주소를 하나 이상 지정합니다. 전자 메일 주소가 여러 개인 경우 각 주소를 쉼표로 구분하여 지정할 수 있습니다.

이 매개 변수를 사용하지 않으면 Complete-MigrationBatch cmdlet을 실행하는 관리자에게 최종 상태 보고서가 전송됩니다.

매개 변수 속성

형식:MultiValuedProperty
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Partition

적용 가능: Exchange Online

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

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

매개 변수 속성

형식:MailboxIdParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SyncAndComplete

적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

SyncAndComplete 스위치는 동기화에 성공한 경우 즉시 동기화를 트리거하고 마이그레이션 일괄 처리가 완료될지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

Input types

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

출력

Output types

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