Set-MigrationBatch

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

Set-MigrationBatch cmdlet을 사용하여 일련의 사용자에 대한 마이그레이션 요청을 업데이트합니다. 자세한 내용은 New-MigrationBatch를 참조하십시오.

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

Syntax

Set-MigrationBatch
   [-Identity] <MigrationBatchIdParameter>
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-ApproveSkippedItems]
   [-AutoRetryCount <Int32>]
   [-BadItemLimit <Unlimited>]
   [-CSVData <Byte[]>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-MoveOptions <MultiValuedProperty>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <TimeSpan>]
   [-SkipMerging <MultiValuedProperty>]
   [-SkipMoving <MultiValuedProperty>]
   [-SkipReports <Boolean>]
   [-SourcePublicFolderDatabase <DatabaseIdParameter>]
   [-StartAfter <DateTime>]
   [-SyncNow]
   [-Update]
   [-WhatIf]
   [<CommonParameters>]

Description

Set-MigrationBatch cmdlet은 사서함 및 사서함 데이터를 다음 시나리오 중 하나로 마이그레이션하도록 기존 마이그레이션 일괄 처리를 구성합니다.

  • 로컬 이동
  • 포리스트 간 이동
  • 원격 이동
  • 단독형 Exchange 마이그레이션
  • 미리 구성된 Exchange 마이그레이션
  • IMAP 마이그레이션
  • Google Workspace(이전의 G Suite) 마이그레이션

일부 설정은 일괄 처리 내의 개별 사용자뿐만 아니라 일괄 처리에도 적용할 수 있습니다. 설정이 사용자에게 적용되면 일괄 처리에서 해당 설정을 재정의한다는 점에 유의해야 합니다.

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

예제

예 1

Set-MigrationBatch -Identity MigrationBatch01 -ApproveSkippedItems

이 예제에서는 이전에 검색된 일괄 처리의 모든 사용자에 대해 건너뛴 모든 항목을 승인하여 MigrationBatch01을 업데이트합니다.

매개 변수

-AllowIncrementalSyncs

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

AllowIncrementalSyncs 매개 변수는 증분 동기화를 사용하도록 설정할지 또는 사용하지 않도록 설정할지 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 증분 동기화를 사용할 수 있습니다. 원본 사서함으로 전송되는 모든 새 메시지는 24시간마다 해당 대상 사서함에 복사됩니다.
  • $false: 증분 동기화를 사용할 수 없습니다. 마이그레이션 일괄 처리는 초기 동기화가 완료된 후 중지됨 상태로 전환됩니다. 로컬 이동, 포리스트 간 이동 또는 원격 이동 마이그레이션에 대한 마이그레이션 일괄 처리를 완료하려면 증분 동기화를 사용하도록 설정해야 합니다.
Type:Boolean
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

-AllowUnknownColumnsInCsv

AllowUnknownColumnsInCsv 매개 변수는 마이그레이션에 사용되지 않는 추가 열을 CSV 파일에서 허용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 마이그레이션은 CSV 파일에서 알 수 없는 열을 무시합니다(철자가 잘못된 열 머리글이 있는 선택적 열 포함). 알 수 없는 모든 열은 마이그레이션에 사용되지 않는 추가 열처럼 처리됩니다.
  • $false: CSV 파일에 알 수 없는 열이 있으면 마이그레이션이 실패합니다. 이 설정은 열 머리글의 맞춤법 오류를 방지합니다. 이 값은 기본값입니다.
Type:Boolean
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

-ApproveSkippedItems

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

ApprovSkippedItems 스위치는 현재 시간 이전에 발견된 건너뛴 모든 항목을 승인된 것으로 표시합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 마이그레이션 중에 검색된 데이터 손실이 중요한 경우 건너뛴 항목을 승인하지 않고는 마이그레이션을 완료할 수 없습니다. 항목이 원본 사서함에서 손상되어 대상 사서함에 복사할 수 없거나, 테넌트용으로 구성된 최대 허용 메시지 크기보다 크거나, 마이그레이션이 완료될 준비가 되면 대상 사서함에서 누락된 것으로 검색되었기 때문에 항목을 건너뛰었을 수 있습니다.

최대 메시지 크기 값에 대한 자세한 내용은 다음 항목 Exchange Online 제한을 참조하세요.

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

-AutoRetryCount

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

AutoRetryCount 매개 변수는 오류가 발생한 사서함을 마이그레이션하기 위해 마이그레이션 일괄 처리를 다시 시작하려고 시도하는 횟수를 지정합니다.

Type:Int32
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

-BadItemLimit

BadItemLimit 매개 변수는 마이그레이션 요청이 실패하기 전에 허용되는 최대 잘못된 항목 수를 지정합니다. 잘못된 항목은 대상 사서함으로 복사할 수 없는 원본 사서함의 손상된 항목입니다. 또한 잘못된 항목 제한에는 누락된 항목도 포함됩니다. 누락된 항목은 마이그레이션 요청을 완료할 준비가 되면 대상 사서함에서 찾을 수 없는 원본 사서함의 항목입니다.

이 매개 변수에는 정수 또는 무제한 값을 입력할 수 있습니다. 기본값은 0입니다. 즉, 잘못된 항목이 검색되면 마이그레이션 요청이 실패합니다. 몇 가지 잘못된 항목을 남겨 두어도 괜찮은 경우 마이그레이션 요청을 진행할 수 있도록 이 매개 변수를 적절한 값(10 이하 권장)으로 설정할 수 있습니다. 잘못된 항목이 너무 많이 검색되면 New-MailboxRepairRequest cmdlet을 사용하여 원본 사서함에서 손상된 항목을 수정하고 마이그레이션 요청을 다시 시도하는 것이 좋습니다.

참고: 이 매개 변수는 클라우드 기반 서비스에서 사용되지 않습니다. 나중에 매개 변수를 사용 하지 않는 경우에는 생략 된 항목 승인 의미론이 대신 사용 됩니다.

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

-CompleteAfter

이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.

CompleteAfter 매개 변수는 일괄 처리가 완료되기 전에 지연을 지정합니다. 일괄 처리에 대한 데이터 마이그레이션이 시작되지만 이 매개 변수를 사용하여 지정한 날짜/시간까지 완료가 시작되지 않습니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

Exchange Online PowerShell에서 표준 시간대 없이 날짜/시간 값을 지정하면 값은 UTC(협정 세계시)에 있습니다. 값을 지정하려면 다음 옵션 중 하나를 사용합니다.

  • UTC에서 날짜/시간 값을 지정합니다(예 "7/30/2020 9:00PM Z": ).
  • 현지 표준 시간대에서 날짜/시간 값을 지정합니다. 예를 들면 "7/30/2020 9:00PM -700"와 같습니다. TimeZone 매개 변수를 사용하지 않으면 값이 UTC로 변환됩니다.
Type:DateTime
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

-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

-CSVData

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

CSVData 매개 변수는 이동하거나 마이그레이션할 사용자 사서함에 대한 정보가 들어 있는 CSV 파일을 지정합니다. CSV 파일의 헤더 행에 필요한 특성은 마이그레이션 유형에 따라 다릅니다.

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

참고: 이 매개 변수는 RBAC 범위에 따라 사서함의 가용성에 대한 유효성을 검사하지 않습니다. CSV 파일에 지정된 모든 사서함은 관리자에게 사서함 마이그레이션 권한을 부여하는 RBAC 범위(예: OU)를 벗어난 경우에도 마이그레이션됩니다.

Type:Byte[]
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

-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

-Identity

Identity 매개 변수는 수정하려는 마이그레이션 일괄 처리를 지정합니다. 마이그레이션 일괄 처리를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면

  • 이름(Identity 속성 값)
  • GUID(BatchGuid 속성 값)
Type:MigrationBatchIdParameter
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

-LargeItemLimit

LargeItemLimit 매개 변수는 마이그레이션 요청이 실패하기 전에 허용되는 최대 큰 항목 수를 지정합니다. 큰 항목은 대상 사서함에서 허용되는 최대 메시지 크기를 초과하는 원본 사서함의 메시지입니다. 대상 사서함에 특수하게 구성된 최대 메시지 크기 값이 지정되지 않은 경우 조직 전체의 값이 사용됩니다.

최대 메시지 크기 값에 대한 자세한 내용은 다음 항목을 참조하세요.

이 매개 변수에는 정수 또는 무제한 값을 입력할 수 있습니다. 기본값은 0입니다. 즉, 큰 항목이 검색되면 마이그레이션 요청이 실패합니다. 몇 가지 큰 항목을 남겨 두는 것이 괜찮은 경우 마이그레이션 요청을 진행할 수 있도록 이 매개 변수를 적절한 값(10 이하 권장)으로 설정할 수 있습니다.

참고: 이 매개 변수는 클라우드 기반 서비스에서 사용되지 않습니다. 나중에 매개 변수를 사용 하지 않는 경우에는 생략 된 항목 승인 의미론이 대신 사용 됩니다.

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

-MoveOptions

MoveOptions 매개 변수는 디버깅을 목적으로 건너뛰려는 마이그레이션 단계를 지정합니다. 이 매개 변수는 Microsoft 고객 서비스 및 지원이나 관련 설명서의 지시가 있는 경우가 아니라면 사용하지 마십시오.

SkipMoving 매개 변수와 함께 이 매개 변수를 사용하지 마십시오.

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

-NotificationEmails

NotificationEmails 매개 변수는 마이그레이션 상태 보고서를 보낼 대상 전자 메일 주소를 하나 이상 지정합니다.

이 매개 변수를 사용하지 않으면 상태 보고서가 전송되지 않습니다.

여러 값을 입력하고 기존 항목을 덮어쓰려면 다음 구문을 Value1,Value2,...ValueN사용합니다. 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.

Type:MultiValuedProperty
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

-Partition

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

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

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

-ReportInterval

ReportInterval 매개 변수는 NotificationEmails 내에 나열된 전자 메일 주소로 전자 메일로 전송되는 보고서를 보내는 빈도를 지정합니다.

기본적으로 메일로 전송된 보고서는 일괄 처리에 대해 24시간마다 전송됩니다. 이 값을 0으로 설정하면 이 일괄 처리에 대한 보고서를 보내서는 안 됩니다.

이 매개 변수는 클라우드 기반 서비스에서만 사용해야 합니다.

Type:TimeSpan
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

-SkipMerging

SkipMerging 매개 변수는 디버깅을 목적으로 건너뛰려는 마이그레이션 단계를 지정합니다. 이 매개 변수는 Microsoft 고객 서비스 및 지원이나 관련 설명서의 지시가 있는 경우가 아니라면 사용하지 마십시오.

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

-SkipMoving

이 매개 변수는 MoveOptions 매개 변수로 바뀌었습니다.

SkipMoving 매개 변수는 디버깅을 목적으로 건너뛰려는 마이그레이션 단계를 지정합니다. 이 매개 변수는 Microsoft 고객 서비스 및 지원이나 관련 설명서의 지시가 있는 경우가 아니라면 사용하지 마십시오.

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

-SkipReports

SkipReports 스위치는 마이그레이션에 대한 자동 보고를 건너뛰도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-SourcePublicFolderDatabase

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

SourcePublicFolderDatabase 매개 변수는 공용 폴더 마이그레이션에 사용되는 원본 공용 폴더 데이터베이스를 지정합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름
  • DN(고유 이름)
  • GUID
Type:DatabaseIdParameter
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

-StartAfter

StartAfter 매개 변수는 일괄 처리 내 사용자에 대한 데이터 마이그레이션이 시작되기 전에 지연을 지정합니다. 마이그레이션이 준비되지만 일괄 처리 내 사용자에 대한 실제 데이터 마이그레이션은 이 매개 변수를 사용하여 지정한 날짜/시간까지 시작되지 않습니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 mm/dd/yyyy의 간단한 날짜 형식을 사용하도록 컴퓨터가 구성된 경우 09/01/2018를 입력하여 2018년 9월 1일을 지정할 수 있습니다. 날짜만 입력하거나 날짜와 시간을 입력할 수도 있습니다. 날짜와 시간을 입력하는 경우 큰따옴표(")로 값을 묶어야 합니다. 예: "09/01/2018 5:00 PM".

Exchange Online PowerShell에서 표준 시간대 없이 날짜/시간 값을 지정하면 값은 UTC(협정 세계시)에 있습니다. 값을 지정하려면 다음 옵션 중 하나를 사용합니다.

  • UTC에서 날짜/시간 값을 지정합니다(예 "7/30/2020 9:00PM Z": ).
  • 현지 표준 시간대에서 날짜/시간 값을 지정합니다. 예를 들면 "7/30/2020 9:00PM -700"와 같습니다. TimeZone 매개 변수를 사용하지 않으면 값이 UTC로 변환됩니다.
Type:DateTime
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

-SyncNow

SyncNow 스위치는 이미 동기화된 상태에 도달했지만 실패한 사용자를 다시 시작하지 않는 사용자에 대해 즉시 동기화를 시작합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하여 이동이 완료되기 직전에 스위치를 사용하여 온보딩 이동 속도를 높일 수 있습니다. IMAP 마이그레이션의 경우 MX 레코드 전환 후 이 스위치를 사용할 수 있습니다.

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

-Update

업데이트 스위치는 마이그레이션 일괄 처리에서 업데이트 플래그를 설정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

업데이트 플래그는 마이그레이션 서비스에서 엔드포인트, 일괄 처리 및 사용자의 모든 설정을 마이그레이션 프로세스에 다시 적용하도록 트리거합니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, 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은 데이터를 반환하지 않습니다.