New-MigrationBatch

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

New-MigrationBatch cmdlet을 사용하여 사용자의 일괄 처리에 대한 새로운 마이그레이션 요청을 전송합니다.

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

Syntax

New-MigrationBatch
   -Name <String>
   [-CSVData <Byte[]>]
   [-DisallowExistingUsers]
   [-WorkflowControlFlags <MigrationWorkflowControlFlags>]
   [-AdoptPreexisting]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-ArchiveDomain <String>]
   [-ArchiveOnly]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-AvoidMergeOverlap]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-ContentFilter <String>]
   [-ContentFilterLanguage <CultureInfo>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ExcludeDumpsters]
   [-ExcludeFolders <MultiValuedProperty>]
   [-ForwardingDisposition <GmailForwardingDisposition>]
   [-IncludeFolders <MultiValuedProperty>]
   [-LargeItemLimit <Unlimited>]
   [-Locale <CultureInfo>]
   [-MoveOptions <MultiValuedProperty>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-PrimaryOnly]
   [-RemoveOnCopy]
   [-RenamePrimaryCalendar]
   [-ReportInterval <Timespan>]
   [-Restore]
   [-SkipCalendar]
   [-SkipContacts]
   [-SkipMail]
   [-SkipMerging <MultiValuedProperty>]
   [-SkipMoving <MultiValuedProperty>]
   [-SkipReports]
   [-SkipRules]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-SourceEndpoint <MigrationEndpointIdParameter>]
   [-SourcePFPrimaryMailboxGuid <Guid>]
   [-StartAfter <DateTime>]
   [-TargetArchiveDatabases <MultiValuedProperty>]
   [-TargetDatabases <MultiValuedProperty>]
   [-TargetDeliveryDomain <String>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]
New-MigrationBatch
   -Name <String>
   -CSVData <Byte[]>
   [-DisallowExistingUsers]
   [-AdoptPreexisting]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-ArchiveDomain <String>]
   [-ArchiveOnly]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-Locale <CultureInfo>]
   [-MoveOptions <MultiValuedProperty>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-PrimaryOnly]
   [-RemoveOnCopy]
   [-ReportInterval <Timespan>]
   [-SkipMerging <MultiValuedProperty>]
   [-SkipMoving <MultiValuedProperty>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TargetArchiveDatabases <MultiValuedProperty>]
   [-TargetDatabases <MultiValuedProperty>]
   [-TargetDeliveryDomain <String>]
   [-TargetEndpoint <MigrationEndpointIdParameter>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]
New-MigrationBatch
   [-Local]
   -Name <String>
   -CSVData <Byte[]>
   [-DisallowExistingUsers]
   [-WorkloadType <RequestWorkloadType>]
   [-WorkflowControlFlags <MigrationWorkflowControlFlags>]
   [-AdoptPreexisting]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-ArchiveOnly]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Locale <CultureInfo>]
   [-MoveOptions <MultiValuedProperty>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-PrimaryOnly]
   [-RemoveOnCopy]
   [-ReportInterval <Timespan>]
   [-SkipMoving <MultiValuedProperty>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TargetArchiveDatabases <MultiValuedProperty>]
   [-TargetDatabases <MultiValuedProperty>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]
New-MigrationBatch
   -Name <String>
   -CSVData <Byte[]>
   -SourcePublicFolderDatabase <DatabaseIdParameter>
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipMerging <MultiValuedProperty>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]
New-MigrationBatch
   -Name <String>
   [-UserIds] <MultiValuedProperty>
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DisableOnCopy]
   [-DomainController <Fqdn>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]
New-MigrationBatch
   -Name <String>
   [-Users] <MultiValuedProperty>
   [-AllowIncrementalSyncs <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DisableOnCopy]
   [-DomainController <Fqdn>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]
New-MigrationBatch
   -Name <String>
   -CSVData <Byte[]>
   [-PublicFolderToUnifiedGroup]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-SourceEndpoint <MigrationEndpointIdParameter>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]
New-MigrationBatch
   -Name <String>
   [-WorkflowTemplate <String>]
   [-AllowIncrementalSyncs <Boolean>]
   [-AllowUnknownColumnsInCsv <Boolean>]
   [-AutoComplete]
   [-AutoRetryCount <Int32>]
   [-AutoStart]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Locale <CultureInfo>]
   [-NotificationEmails <MultiValuedProperty>]
   [-Partition <MailboxIdParameter>]
   [-ReportInterval <Timespan>]
   [-SkipReports]
   [-SkipSteps <SkippableMigrationSteps[]>]
   [-StartAfter <DateTime>]
   [-TimeZone <ExTimeZoneValue>]
   [-WhatIf]
   [<CommonParameters>]

Description

다음 마이그레이션 시나리오 중 하나로 New-MigrationBatch cmdlet을 사용하여 사서함과 사서함 데이터를 마이그레이션하는 마이그레이션 일괄 처리를 만듭니다.

온-프레미스 Exchange 조직에서의 이동

  • 로컬 이동: 로컬 이동은 사서함을 한 사서함 데이터베이스에서 다른 사서함 데이터베이스로 이동하는 위치입니다. 로컬 이동은 단일 포리스트 내에서 발생합니다. 자세한 내용은 예 1를 참조하십시오.
  • 포리스트 간 엔터프라이즈 이동: 포리스트 간 엔터프라이즈 이동에서 사서함은 다른 포리스트로 이동됩니다. 포리스트 간 이동은 사서함을 이동할 포리스트인 대상 포리스트나 현재 사서함을 호스트하는 포리스트인 원본 포리스트에서 시작됩니다. 자세한 내용은 예 2를 참조하십시오.

Exchange Online의 온보딩 및 오프보딩

  • 원격 이동 마이그레이션 온보딩: 하이브리드 배포에서 온-프레미스 Exchange organization 사서함을 Exchange Online 이동할 수 있습니다. 사서함을 Exchange Online 온보딩하기 때문에 온보딩 원격 이동 마이그레이션이라고도 합니다. 자세한 내용은 예 3을 참조하십시오.

  • 오프보딩 원격 이동 마이그레이션: Exchange Online 사서함을 온-프레미스 Exchange 조직으로 마이그레이션하는 오프보딩 원격 이동 마이그레이션을 수행할 수도 있습니다. 자세한 내용은 예 4를 참조하십시오.

    온보딩 및 오프보딩 원격 이동 마이그레이션은 모두 Exchange Online 조직에서 시작됩니다.

  • 단독형 Exchange 마이그레이션: 이는 온보딩 마이그레이션의 또 다른 유형이며 온-프레미스 Exchange organization 모든 사서함을 Exchange Online 마이그레이션하는 데 사용됩니다. 단독형 마이그레이션을 사용하여 최대 1,000개의 Exchange Server 2003, Exchange Server 2007 또는 Exchange Server 2010 사서함을 마이그레이션할 수 있습니다. 단독형 Exchange 마이그레이션을 수행할 때 사서함은 Exchange Online 자동으로 프로비전됩니다. 자세한 내용은 예 5를 참조하십시오.

  • 단계적 Exchange 마이그레이션: 온-프레미스 Exchange organization 사서함의 하위 집합을 Exchange Online 마이그레이션할 수도 있습니다. 이는 또 다른 유형의 온보딩 마이그레이션입니다. Exchange 2010 이상 버전의 Exchange에서 사서함 마이그레이션은 단계적 마이그레이션을 사용하여 지원되지 않습니다. 미리 구성된 마이그레이션을 실행하기 전에 디렉터리 동기화 또는 다른 방법을 사용하여 Exchange Online organization 메일 사용자를 프로비전해야 합니다. 자세한 내용은 예 6을 참조하십시오.

  • IMAP 마이그레이션: 이 온보딩 마이그레이션 유형은 사서함 데이터를 IMAP 서버(Exchange 포함)에서 Exchange Online 마이그레이션합니다. IMAP 마이그레이션의 경우 사서함 데이터를 마이그레이션하려면 먼저 Exchange Online 사서함을 프로비전해야 합니다. 자세한 내용은 예 7을 참조하십시오.

  • Google Workspace(이전의 G Suite) 마이그레이션: 이 온보딩 마이그레이션 유형은 Google Workspace organization 사서함 데이터를 Exchange Online 마이그레이션합니다. Google Workspace 마이그레이션의 경우 사서함 데이터를 마이그레이션하려면 먼저 Exchange Online 메일 사용자(또는 사서함)를 프로비전해야 합니다. 자세한 내용은 예제 10을 참조하세요.

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

예제

예 1

New-MigrationBatch -Local -Name LocalMove1 -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\LocalMove1.csv")) -TargetDatabases MBXDB2

Start-MigrationBatch -Identity LocalMove1

이 예에서는 지정된 CSV 파일의 사서함이 다른 사서함 데이터베이스로 이동되는 로컬 이동을 위한 마이그레이션 일괄 처리를 만듭니다. 이 CSV 파일에는 이동될 사서함의 전자 메일 주소가 있는 단일 열이 포함되어 있습니다. 이 열의 헤더 이름은 EmailAddress로 지정해야 합니다. 이 예제의 마이그레이션 일괄 처리는 Start-MigrationBatch cmdlet 또는 Exchange 관리 센터를 사용하여 수동으로 시작해야 합니다. 또는 AutoStart 매개 변수를 사용하여 마이그레이션 일괄 처리를 자동으로 시작할 수 있습니다.

예 2

$Credentials = Get-Credential

$MigrationEndpointSource = New-MigrationEndpoint -ExchangeRemoteMove -Name Forest1Endpoint -Autodiscover -EmailAddress administrator@forest1.contoso.com -Credentials $Credentials

$CrossForestBatch = New-MigrationBatch -Name CrossForestBatch1 -SourceEndpoint $MigrationEndpointSource.Identity -TargetDeliveryDomain forest2.contoso.com -TargetDatabases MBXDB1 -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\CrossForestBatch1.csv"))

Start-MigrationBatch -Identity $CrossForestBatch.Identity

다음은 CSV 파일에 지정된 메일 사용자의 사서함이 다른 포리스트로 이동하는 포리스트 간 엔터프라이즈 이동에 대한 마이그레이션 일괄 처리를 만드는 예제입니다. 사서함이 현재 있는 도메인을 식별하는 새 마이그레이션 엔드포인트가 만들어집니다. 엔드포인트는 마이그레이션 일괄 처리를 만드는 데 사용됩니다. 그런 다음 Start-MigrationBatch cmdlet을 사용하여 마이그레이션 일괄 처리가 시작됩니다. 포리스트 간 이동은 사서함을 이동하려는 포리스트인 대상 포리스트에서 시작됩니다.

예 3

$Credentials = Get-Credential

$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials

$OnboardingBatch = New-MigrationBatch -Name RemoteOnBoarding1 -SourceEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain contoso.mail.onmicrosoft.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOnBoarding1.csv"))

Start-MigrationBatch -Identity $OnboardingBatch.Identity.Name

이 예제에서는 온보딩 원격 이동 마이그레이션을 위한 마이그레이션 일괄 처리를 온-프레미스 Exchange organization Exchange Online 만듭니다. 구문은 포리스트 간 이동의 구문과 유사하지만 Exchange Online organization 시작됩니다. 온-프레미스 조직을 마이그레이션될 사서함의 원본 위치로 가리키는 새 마이그레이션 끝점이 생성됩니다. 이 끝점은 마이그레이션 일괄 처리를 만드는 데 사용됩니다. 그런 다음 Start-MigrationBatch cmdlet을 사용하여 마이그레이션 일괄 처리가 시작됩니다.

예 4

$Credentials = Get-Credential

$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials

$OffboardingBatch = New-MigrationBatch -Name RemoteOffBoarding1 -TargetEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain onprem.contoso.com -TargetDatabases @(MBXDB01,MBXDB02,MBXDB03) -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOffBoarding1.csv"))

Start-MigrationBatch -Identity $OffboardingBatch.Identity

이 예제에서는 온-프레미스 Exchange organization Exchange Online 오프보딩 원격 이동 마이그레이션을 위한 마이그레이션 일괄 처리를 만듭니다. 온보딩 원격 이동과 마찬가지로 Exchange Online organization 시작됩니다. 먼저 온-프레미스 조직에 연결하는 방법에 대한 정보를 포함하는 마이그레이션 끝점을 만듭니다. 이 끝점은 나중에 Start-MigrationBatch cmdlet을 사용하여 시작될 마이그레이션 일괄 처리를 만드는 데 TargetEndpoint로 사용됩니다. TargetDatabases 매개 변수는 마이그레이션 서비스가 사서함을 이동할 대상 데이터베이스로 선택할 수 있는 여러 온-프레미스 데이터베이스를 지정합니다.

예 5

$credentials = Get-Credential

$SourceEndpoint = New-MigrationEndpoint -ExchangeOutlookAnywhere -Autodiscover -Name SourceEndpoint -EmailAddress administrator@contoso.com -Credentials $credentials

New-MigrationBatch -Name CutoverBatch -SourceEndpoint $SourceEndpoint.Identity -TimeZone "Pacific Standard Time" -AutoStart

이 예제에서는 자동으로 시작되는 단독형 Exchange 마이그레이션 CutoverBatch에 대한 마이그레이션 일괄 처리를 만듭니다. 이 예제에서는 온-프레미스 Exchange 서버에 대한 연결 설정을 가져온 다음, 이러한 연결 설정을 사용하여 마이그레이션 엔드포인트를 만듭니다. 그런 다음 이 끝점은 마이그레이션 일괄 처리를 만드는 데 사용됩니다. 이 예제에는 선택적 TimeZone 매개 변수도 포함되어 있습니다.

예 6

$Credentials = Get-Credential

$MigrationEndpoint = New-MigrationEndpoint -ExchangeOutlookAnywhere -Name ContosoEndpoint -Autodiscover -EmailAddress administrator@contoso.com -Credentials $Credentials

$StagedBatch1 = New-MigrationBatch -Name StagedBatch1 -SourceEndpoint $MigrationEndpoint.Identity -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\StagedBatch1.csv"))

Start-MigrationBatch -Identity $StagedBatch1.Identity

이 예제에서는 스테이징된 Exchange 마이그레이션에 대한 마이그레이션 일괄 처리를 만들고 시작합니다. 이 예제에서는 New-MigrationEndpoint cmdlet을 사용하여 온-프레미스 Exchange 서버에 대한 마이그레이션 엔드포인트를 만든 다음, 해당 엔드포인트를 사용하여 마이그레이션 일괄 처리를 만듭니다. 마이그레이션 일괄 처리는 Start-MigrationBatch cmdlet을 사용하여 시작됩니다.

예 7

New-MigrationEndpoint -IMAP -Name IMAPEndpoint1 -RemoteServer imap.contoso.com -Port 993

New-MigrationBatch -Name IMAPbatch1 -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\IMAPmigration_1.csv")) -SourceEndpoint IMAPEndpoint1 -ExcludeFolders "Deleted Items","Junk Email"

이 예에서는 IMAP 서버 연결 설정을 위한 마이그레이션 끝점을 만듭니다. 그런 다음 CSV 마이그레이션 파일 IMAPmigration_1.csv를 사용하고 지운 편지함 및 정크 메일 폴더의 내용을 제외하는 IMAP 마이그레이션 일괄 처리를 만듭니다. 이 마이그레이션 일괄 처리는 Start-MigrationBatch cmdlet을 사용하여 시작할 때까지 보류됩니다.

예 8

$Credentials = Get-Credential

$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials

$OnboardingBatch = New-MigrationBatch -Name RemoteOnBoarding1 -SourceEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain contoso.mail.onmicrosoft.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOnBoarding1.csv")) -CompleteAfter "09/01/2018 7:00 PM"

Start-MigrationBatch -Identity $OnboardingBatch.Identity

이 예제는 예제 3과 동일하지만 CompleteAfter 매개 변수도 사용됩니다. 일괄 처리에 대한 데이터 마이그레이션이 시작되지만 2018/09/01/7:00 PM(UTC)까지 완료되지 않습니다. 이 방법을 사용하면 마이그레이션을 시작한 다음 표준 시간대가 협정 세계시인 경우 업무 시간 후에 완료되도록 둡니다.

예제 9

$Credentials = Get-Credential

$MigrationEndpointOnPrem = New-MigrationEndpoint -ExchangeRemoteMove -Name OnpremEndpoint -Autodiscover -EmailAddress administrator@onprem.contoso.com -Credentials $Credentials

$OnboardingBatch = New-MigrationBatch -Name RemoteOnBoarding1 -SourceEndpoint $MigrationEndpointOnprem.Identity -TargetDeliveryDomain contoso.mail.onmicrosoft.com -CSVData ([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\RemoteOnBoarding1.csv")) -CompleteAfter "09/01/2018 7:00 PM" -TimeZone "Pacific Standard Time"

Start-MigrationBatch -Identity $OnboardingBatch.Identity

이 예제는 예제 8과 동일하지만 TimeZone 매개 변수도 사용됩니다. 일괄 처리에 대한 데이터 마이그레이션이 시작되지만 2018/09/01/7:00 PM(PST)까지 완료되지 않습니다. 이 방법을 사용하면 마이그레이션을 시작한 다음 표준 시간대가 태평양 표준시인 경우 업무 시간 후에 완료되도록 둡니다.

예제 10

$MigrationEndpointGmail = New-MigrationEndpoint -Gmail -ServiceAccountKeyFileData $([System.IO.File]::ReadAllBytes("C:\Users\Administrator\Desktop\gmailonboarding.json")) -EmailAddress admin@contoso.com -Name GmailEndpoint

$OnboardingBatch = New-MigrationBatch -SourceEndpoint $MigrationEndpointGmail.Identity -Name GmailBatch1 -CSVData $([System.IO.File]::ReadAll
Bytes("C:\Users\Administrator\Desktop\gmail.csv")) -TargetDeliveryDomain "o365.contoso.com" -ContentFilter "Received -ge '2019/4/30'" -Inc
ludeFolders "Payment"

Start-MigrationBatch -Identity $OnboardingBatch.Identity

CSV 마이그레이션 파일 gmail.csv 사용하고 결제 레이블의 콘텐츠를 포함하고 '2019/4/30 00:00' (로컬 시스템 시간) 이후에 받은 메일만 마이그레이션하는 Google Workspace 마이그레이션 일괄 처리가 만들어집니다. 이 마이그레이션 일괄 처리는 Start-MigrationBatch cmdlet을 사용하여 시작할 때까지 보류됩니다.

매개 변수

-AdoptPreexisting

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

{{ Fill AdoptPreexisting description }}

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

-AllowIncrementalSyncs

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

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

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

-ArchiveDomain

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

{{ Fill ArchiveDomain Description }}

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

-ArchiveOnly

ArchiveOnly 스위치는 마이그레이션 일괄 처리에 사용자에 대해 보관 사서함만 마이그레이션되도록 지정합니다(기본 사서함은 마이그레이션되지 않음). 이 스위치를 사용하여 값을 지정할 필요는 없습니다.

이 스위치는 로컬 이동 및 원격 이동 마이그레이션에만 사용할 수 있습니다.

TargetArchiveDatabases 매개 변수를 사용하여 보관 사서함을 이동할 대상 데이터베이스를 지정할 수 있습니다. 대상 보관 데이터베이스를 CSV 파일에 지정할 수도 있습니다. 대상 보관 데이터베이스를 지정하지 않으면 cmdlet에서 자동 사서함 배포 논리를 사용하여 데이터베이스를 선택합니다.

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

-AutoComplete

AutoComplete 스위치는 사서함의 초기 동기화가 완료되는 즉시 개별 사서함을 강제로 완료합니다. 이 스위치를 사용하여 값을 지정할 필요는 없습니다.

이 스위치는 로컬 이동 및 원격 이동 마이그레이션에만 사용할 수 있습니다.

이 스위치를 사용하지 않는 경우에는 Complete-MigrationBatch cmdlet을 실행하여 마이그레이션 일괄 처리를 완료해야 합니다.

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

-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

-AutoStart

AutoStart 스위치는 새 마이그레이션 일괄 처리의 처리를 즉시 시작합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

스위치를 사용하지 않는 경우에는 Start-MigrationBatch cmdlet을 사용하여 마이그레이션 일괄 처리를 수동으로 시작해야 합니다.

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

-AvoidMergeOverlap

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

{{ Fill AvoidMergeOverlap description }}

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

-BadItemLimit

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

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

참고: 이 매개 변수는 클라우드 기반 서비스에서 사용되지 않습니다. 나중에 BadItemLimit 또는 LargeItemLimit 매개 변수를 지정하지 않으면 마이그레이션에서 BadItemLimit 의미 체계 대신 건너뛴 항목 승인 의미 체계를 사용합니다.

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

-ContentFilter

이 매개 변수는 IMAP 마이그레이션 및 Google Workspace 마이그레이션을 위한 클라우드 기반 서비스에서만 사용할 수 있습니다.

ContentFilter 매개 변수는 OPATH 필터 구문을 사용하여 수신 시간별로 메시지를 필터링합니다. ContentFilter 매개 변수와 일치하는 콘텐츠만 Exchange Online으로 이동됩니다. 예를 들면

  • "Received -gt '8/23/2020'"
  • "Received -le '2019/01/01'"
  • "Received -gt '8/23/2015' -and Received -lt '8/23/2020'"

ContentFilterLanguage 매개 변수를 사용하여 언어를 지정할 수 있습니다.

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

-ContentFilterLanguage

이 매개 변수는 IMAP 마이그레이션 및 Google Workspace 마이그레이션을 위한 클라우드 기반 서비스에서만 사용할 수 있습니다.

ContentFilterLanguage 매개 변수는 문자열 검색에서 ContentFilter 매개 변수에 사용되는 언어를 지정합니다.

이 매개 변수에 대한 유효한 입력은 Microsoft .NET Framework CultureInfo 클래스에서 지원되는 문화권 코드 값입니다. 예를 들어 덴마크어의 경우 da-DK, 일본어의 경우 ja-JP입니다. 자세한 내용은 CultureInfo 클래스를 참조하세요.

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

-CSVData

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

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

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

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

-DisableOnCopy

DisableOnCopy 스위치는 UserIds 또는 Users 매개 변수를 사용하여 기존 일괄 처리에서 새 일괄 처리로 사용자를 복사하는 경우 사용자의 원래 마이그레이션 작업 항목을 사용하지 않도록 설정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-DisallowExistingUsers

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

DisallowExistingUsers 스위치는 현재 다른 마이그레이션 일괄 처리에 정의된 사서함의 마이그레이션을 방지합니다. 이 스위치를 사용하여 값을 지정할 필요는 없습니다.

대상에 기존 사서함이 있으면 유효성 검사 경고가 표시됩니다.

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

-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

-ExcludeDumpsters

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

ExcludeDumpsters 스위치는 복구 가능한 항목 폴더(이전의 쓰레기통)의 내용을 포함하지 않고 공용 폴더 사서함을 마이그레이션할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 Exchange 2013 이상에서 Exchange Online 공용 폴더 마이그레이션에서만 사용합니다.

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

-ExcludeFolders

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

IMAP 마이그레이션 또는 Google 작업 영역 마이그레이션의 경우 ExcludeFolders 매개 변수는 원본 전자 메일 시스템에서 클라우드 기반 사서함으로 마이그레이션하지 않으려는 사서함 폴더를 지정합니다. 값을 문자열 배열로 지정하고 폴더 이름이 여러 개인 경우 각 이름을 쉼표로 구분합니다.

IMAP 마이그레이션의 경우 원본 메일 서버의 IMAP 루트를 기준으로 폴더 이름을 사용합니다. Google Workspace 마이그레이션의 경우 원본 메일 서버에서 레이블 이름을 사용합니다.

오프-프레미스 사서함에 Single Sign-On을 허용하도록 AD FS(exADNoMk 페더레이션 서비스)가 배포되어 있고 AD FS가 Sign-On 토큰 요청에 대해 ExchangeGUID가 아닌 특성을 사용하도록 구성된 경우는 ImmutableId 매개 변수를 설정해야 합니다. exExchangeNoVersion 및 AD FS 둘 다는 프레미스 간 exExchangeNoVersion 배포 시나리오에서 올바르게 작동할 수 있도록 동일한 사용자에 대해 동일한 토큰을 요청해야 합니다.

<FolderName>/*: 이 구문을 사용하여 SourceRootFolder 매개 변수에 지정된 폴더 아래에 있는 개인 폴더(예 MyProjects : 또는 MyProjects/FY2010)를 나타냅니다.

#<FolderName>#/*: 이 구문을 사용하여 다른 언어의 폴더 이름에 관계없이 잘 알려진 폴더를 나타냅니다. 예를 들어 #Inbox#은 받은 편지함이 터키어(Gelen Kutusu)로 지역화된 경우에도 받은 편지함 폴더를 표시합니다. 잘 알려진 폴더에는 다음 유형이 포함됩니다.

  • 루트
  • 받은 편지함
  • SentItems
  • 보낼 편지함
  • DeletedItems
  • 일정
  • 연락처
  • 초안
  • 저널
  • 작업
  • 참고
  • AllItems
  • JunkEmail
  • 보관

사용자가 잘 알려진 폴더와 이름이 같은 개인 폴더와 # 폴더를 둘러싼 기호를 만드는 경우 백슬래시(\)를 이스케이프 문자로 사용하여 해당 폴더를 지정할 수 있습니다. 예를 들어 사용자가 라는 #Notes# 폴더를 만들고 잘 알려진 Notes 폴더 대신 해당 폴더를 지정하려는 경우 다음 구문을 \#Notes\#사용합니다.

사용자가 잘 알려진 폴더 이름으로 개인 폴더를 만들고 앞뒤에 #을 추가한 경우 이 폴더를 지정할 때 백슬래시(\)를 이스케이프 문자로 사용할 수 있습니다. 예를 들어 사용자가 #Notes#라는 폴더를 만든 경우 잘 알려진 Notes 폴더가 아닌 이 폴더를 지정하려면 다음 구문을 사용합니다. \#Notes\#.

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

-ForwardingDisposition

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

{{ Fill ForwardingDisposition Description }}

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

-IncludeFolders

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

IMAP 마이그레이션 또는 Google 작업 영역 마이그레이션의 경우 IncludeFolders 매개 변수는 온-프레미스 전자 메일 시스템에서 클라우드 기반 사서함으로 마이그레이션할 사서함 폴더를 지정합니다. 값을 문자열 배열로 지정하고 폴더 이름이 여러 개인 경우 각 이름을 쉼표로 구분합니다.

IMAP 마이그레이션의 경우 원본 메일 서버의 IMAP 루트를 기준으로 폴더 이름을 사용합니다. Google Workspace 마이그레이션의 경우 원본 메일 서버에서 레이블 이름을 사용합니다.

오프-프레미스 사서함에 Single Sign-On을 허용하도록 AD FS(exADNoMk 페더레이션 서비스)가 배포되어 있고 AD FS가 Sign-On 토큰 요청에 대해 ExchangeGUID가 아닌 특성을 사용하도록 구성된 경우는 ImmutableId 매개 변수를 설정해야 합니다. exExchangeNoVersion 및 AD FS 둘 다는 프레미스 간 exExchangeNoVersion 배포 시나리오에서 올바르게 작동할 수 있도록 동일한 사용자에 대해 동일한 토큰을 요청해야 합니다.

<FolderName>/*: 이 구문을 사용하여 SourceRootFolder 매개 변수에 지정된 폴더 아래에 있는 개인 폴더(예 MyProjects : 또는 MyProjects/FY2010)를 나타냅니다.

#<FolderName>#/*: 이 구문을 사용하여 다른 언어의 폴더 이름에 관계없이 잘 알려진 폴더를 나타냅니다. 예를 들어 #Inbox#은 받은 편지함이 터키어(Gelen Kutusu)로 지역화된 경우에도 받은 편지함 폴더를 표시합니다. 잘 알려진 폴더에는 다음 유형이 포함됩니다.

  • 루트
  • 받은 편지함
  • SentItems
  • 보낼 편지함
  • DeletedItems
  • 일정
  • 연락처
  • 초안
  • 저널
  • 작업
  • 참고
  • AllItems
  • JunkEmail
  • 보관

사용자가 잘 알려진 폴더와 이름이 같은 개인 폴더와 # 폴더를 둘러싼 기호를 만드는 경우 백슬래시(\)를 이스케이프 문자로 사용하여 해당 폴더를 지정할 수 있습니다. 예를 들어 사용자가 라는 #Notes# 폴더를 만들고 잘 알려진 Notes 폴더 대신 해당 폴더를 지정하려는 경우 다음 구문을 \#Notes\#사용합니다.

사용자가 잘 알려진 폴더 이름으로 개인 폴더를 만들고 앞뒤에 #을 추가한 경우 이 폴더를 지정할 때 백슬래시(\)를 이스케이프 문자로 사용할 수 있습니다. 예를 들어 사용자가 #Notes#라는 폴더를 만든 경우 잘 알려진 Notes 폴더가 아닌 이 폴더를 지정하려면 다음 구문을 사용합니다. \#Notes\#.

Type:MultiValuedProperty
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-Local

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

로컬 스위치는 로컬 이동을 지정합니다(사서함은 동일한 Active Directory 포리스트의 다른 사서함 데이터베이스로 이동됨). 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-Locale

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

Locale 매개 변수는 마이그레이션 일괄 처리의 언어를 지정합니다.

이 매개 변수에 대한 유효한 입력은 Microsoft .NET Framework CultureInfo 클래스에서 지원되는 문화권 코드 값입니다. 예를 들어 덴마크어의 경우 da-DK, 일본어의 경우 ja-JP입니다. 자세한 내용은 CultureInfo 클래스를 참조하세요.

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

-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

-Name

Name 매개 변수는 각 시스템의 마이그레이션 일괄 처리에 대한 고유한 이름을 지정합니다(Exchange 온-프레미스 또는 Exchange Online). 최대 길이는 64자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표로 묶습니다.

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

-NotificationEmails

NotificationEmails 매개 변수는 마이그레이션 상태 보고서를 보낼 대상 전자 메일 주소를 하나 이상 지정합니다. 값을 문자열 배열로 지정하고 전자 메일 주소가 여러 개인 경우 각 주소를 쉼표로 구분합니다.

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

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

-PrimaryOnly

PrimaryOnly 스위치는 마이그레이션 일괄 처리에서 보관 사서함도 있는 사용자에 대해 기본 사서함만 마이그레이션되도록 지정합니다(보관 사서함은 마이그레이션되지 않음). 이 스위치를 사용하여 값을 지정할 필요는 없습니다.

이 스위치는 로컬 이동 및 원격 이동 마이그레이션에만 사용할 수 있습니다.

참고: 사용자에게 보관 사서함이 없는 경우에는 이 스위치를 사용하지 마십시오.

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

-PublicFolderToUnifiedGroup

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

PublicFolderToUnifiedGroup 스위치는 공용 폴더에서 Microsoft 365 그룹 마이그레이션을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-RemoveOnCopy

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

{{ Fill RemoveOnCopy Description }}

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

-RenamePrimaryCalendar

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

{{ Fill RenamePrimaryCalendar description }}

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

-Restore

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

{{ 채우기 복원 설명 }}

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

-SkipCalendar

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

SkipCalendar 스위치는 Google 작업 영역 온보딩 중에 일정 마이그레이션을 건너뛰도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-SkipContacts

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

SkipContacts 스위치는 Google Workspace 온보딩 중에 연락처 마이그레이션을 건너뛰도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-SkipMail

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

SkipMail 스위치는 Google 작업 영역 온보딩 중에 메일 마이그레이션을 건너뛰도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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: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

-SkipRules

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

SkipRules 스위치는 Google 작업 영역 온보딩 중에 규칙 마이그레이션을 건너뛰도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

-SkipSteps

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

SkipSteps 매개 변수는 건너뛸 스테이징된 Exchange 마이그레이션의 단계를 지정합니다. 유효한 값은 다음과 같습니다.

  • 없음(기본값)
  • SettingTargetAddress: 원본 사서함에서 대상 전자 메일 주소를 설정하지 마세요. 이 설정을 사용하면 메일이 원래 사서함에서 마이그레이션된 새 사서함으로 전달되지 않습니다.

이 매개 변수는 준비된 Exchange 마이그레이션에만 적용됩니다.

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

-SourceEndpoint

SourceEndpoint 매개 변수는 마이그레이션 일괄 처리의 원본으로 사용할 마이그레이션 끝점을 지정합니다. New-MigrationEndpoint cmdlet을 사용하여 마이그레이션 엔드포인트를 만듭니다. 마이그레이션 끝점을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름(Identity 속성 값)
  • GUID

이 매개 변수는 원본 사서함이 있는 서버에 연결하는 데 사용되는 설정을 정의합니다.

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

-SourcePFPrimaryMailboxGuid

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

{{ Fill SourcePFPrimaryMailboxGuid Description }}

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

-SourcePublicFolderDatabase

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

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

  • 이름
  • DN(고유 이름)
  • GUID
Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
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

-TargetArchiveDatabases

TargetArchiveDatabases 매개 변수는 마이그레이션 일괄 처리에 지정된 보관 사서함을 마이그레이션할 대상 데이터베이스를 지정합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름
  • DN(고유 이름)
  • GUID

Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "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

-TargetDatabases

TargetDatabases 매개 변수는 사서함을 이동할 대상 데이터베이스의 ID를 지정합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

  • 이름
  • DN(고유 이름)
  • GUID

Update 값에 공백이 포함되거나 따옴표가 필요한 경우 다음 구문을 "Value1","Value2",..."ValueN"사용합니다.

여러 값을 입력하면 마이그레이션 서비스에서 사서함을 이동할 대상 데이터베이스로 데이터베이스 하나를 선택합니다.

이 매개 변수는 로컬 이동 및 원격 이동 마이그레이션에만 사용할 수 있습니다.

로컬 이동에 이 매개 변수를 사용하지 않는 경우 cmdlet은 자동 사서함 배포 논리를 사용하여 데이터베이스를 선택합니다.

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

-TargetDeliveryDomain

TargetDeliveryDomain 매개 변수는 마이그레이션 일괄 처리가 완료될 때 mail-enabled user에 대해 원본 포리스트에 만들어지는 외부 전자 메일 주소의 FQDN을 지정합니다.

이 매개 변수는 원격 이동 온보딩 및 원격 오프보딩 마이그레이션 일괄 처리에 필요합니다.

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

-TargetEndpoint

TargetEndpoint 매개 변수는 마이그레이션 일괄 처리의 대상으로 사용할 마이그레이션 끝점을 지정합니다. New-MigrationEndpoint cmdlet을 사용하여 마이그레이션 엔드포인트를 만듭니다. 마이그레이션 끝점을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

  • 이름(Identity 속성 값)
  • GUID

이 매개 변수는 사서함이 이동될 대상 서버에 연결하는 데 사용되는 설정을 정의합니다.

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

-TimeZone

TimeZone 매개 변수는 마이그레이션 일괄 처리를 전송하는 관리자의 표준 시간대를 지정합니다.

이 매개 변수의 유효한 값은 지원되는 표준 시간대 키 이름(예: "Pacific Standard Time")입니다.

사용 가능한 값을 보려면 명령을 $TimeZone = Get-ChildItem "HKLM:\Software\Microsoft\Windows NT\CurrentVersion\Time zones" | foreach {Get-ItemProperty $_.PSPath}; $TimeZone | sort Display | Format-Table -Auto PSChildname,Display실행합니다.

값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

온-프레미스 Exchange에서 기본값은 Exchange 서버의 표준 시간대 설정입니다.

Exchange Online 기본값은 입니다UTC.

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

-UserIds

UserIds 매개 변수는 기존 마이그레이션 일괄 처리에서 복사하고자 하는 사용자를 지정합니다(예: 이전 마이그레이션이 부분적으로 성공한 경우). 전자 메일 주소 또는 Get-MigrationUser cmdlet의 Guid 속성 값으로 사용자를 식별합니다. 여러 사용자를 쉼표로 구분하여 지정할 수 있습니다.

이 매개 변수에 대해 지정하는 사용자는 기존 마이그레이션 일괄 처리에 정의되어 있어야 합니다.

원래 마이그레이션 일괄 처리의 사용자 마이그레이션을 사용하지 않으려면 이 매개 변수와 함께 DisableOnCopy 스위치를 사용합니다.

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

-Users

Users 매개 변수는 기존 마이그레이션 일괄 처리에서 복사하려는 사용자를 지정합니다(예: 이전 마이그레이션이 부분적으로 성공한 경우). Get-MigrationUser cmdlet을 사용하여 사용자를 식별합니다. 예를 들면

$Failed = Get-MigrationUser -상태 실패

New-MigrationBatch -이름 "실패한 사용자 다시 시도" -사용자 $Failed

이 매개 변수에 대해 지정하는 사용자는 기존 마이그레이션 일괄 처리에 정의되어 있어야 합니다.

원래 마이그레이션 일괄 처리의 사용자 마이그레이션을 사용하지 않으려면 이 매개 변수와 함께 DisableOnCopy 스위치를 사용합니다.

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

-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

-WorkflowControlFlags

WorkflowControlFlags 매개 변수는 마이그레이션에서 수행되는 단계에 대한 고급 컨트롤을 지정합니다. 유효한 값은 다음과 같습니다.

  • 없음(기본값)
  • InjectAndForget
  • SkipSwitchover

이 매개 변수는 Microsoft 고객 서비스 및 지원이나 관련 설명서의 지시가 있는 경우가 아니라면 사용하지 마십시오.

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

-WorkflowTemplate

WorkflowTemplate 매개 변수는 마이그레이션에서 수행되는 단계에 대한 고급 컨트롤을 지정합니다. 이 매개 변수는 Microsoft 고객 서비스 및 지원이나 관련 설명서의 지시가 있는 경우가 아니라면 사용하지 마십시오.

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

-WorkloadType

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

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

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

입력

Input types

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

출력

Output types

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