Set-MigrationBatch
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수 및 설정은 한 환경이나 다른 환경에서만 사용할 수 있습니다.
Set-MigrationBatch cmdlet을 사용하여 일련의 사용자에 대한 마이그레이션 요청을 업데이트합니다. 자세한 내용은 New-MigrationBatch를 참조하십시오.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Set-MigrationBatch
[-Identity] <MigrationBatchIdParameter>
[-AddUsers]
[-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을 업데이트합니다.
예 2
`Set-MigrationBatch -Identity MigrationBatch01 -AddUsers -CSVData ([System.IO.File]::ReadAllBytes('C:\Data\MigrationBatch01.csv'))`
클라우드 기반 서비스에서 이 예제에서는 MigrationBatch01이라는 기존 마이그레이션 배치에 새 사용자를 추가합니다. 새 사용자는 원래 마이그레이션 일괄 처리를 만드는 데 사용된 파일 C:\Data\MigrationBatch01.csv에서 식별됩니다. 파일의 새 사용자만 처리됩니다.
매개 변수
-AddUsers
적용 가능: Exchange Online
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
AddUsers 스위치는 전체 일괄 처리를 다시 만들거나 다시 제출하지 않고 기존 마이그레이션 일괄 처리에 사용자를 점진적으로 추가할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치를 CSVData 매개 변수와 함께 사용합니다. 지정된 CSV 파일의 형식은 마이그레이션 일괄 처리를 만드는 데 사용되는 CSV 파일과 동일해야 합니다. CSV 파일의 새 항목만 처리됩니다. 자세한 내용은 예제 섹션의 예제 2를 참조하세요.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AllowIncrementalSyncs
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
AllowIncrementalSyncs 매개 변수는 증분 동기화를 사용하도록 설정할지 또는 사용하지 않도록 설정할지 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 증분 동기화를 사용할 수 있습니다. 원본 사서함으로 전송되는 모든 새 메시지는 24시간마다 한 번씩 해당 대상 사서함에 복사됩니다.
- $false: 증분 동기화를 사용할 수 없습니다. 마이그레이션 일괄 처리는 초기 동기화가 완료된 후 중지됨 상태가 됩니다. 로컬 이동, 포리스트 간 이동 또는 원격 이동 마이그레이션에 대한 마이그레이션 배치를 완료하려면 증분 동기화를 활성화해야 합니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AllowUnknownColumnsInCsv
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
AllowUnknownColumnsInCsv 매개 변수는 마이그레이션에 사용되지 않는 추가 열을 CSV 파일에서 허용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 마이그레이션은 CSV 파일에서 알 수 없는 열(맞춤법이 잘못된 열 머리글이 있는 선택적 열 포함)을 무시(자동으로 건너뛰기)합니다. 알 수 없는 모든 열은 마이그레이션에서 사용되지 않는 추가 열로 처리됩니다.
- $false: CSV 파일에 알 수 없는 열이 있으면 마이그레이션이 실패합니다. 이 설정은 열 머리글의 맞춤법 오류를 방지합니다. 이 값이 기본값입니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ApproveSkippedItems
적용 가능: Exchange Online
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
ApproveSkippedItems 스위치는 현재 시간 이전에 검색된 건너뛴 모든 항목을 승인된 것으로 표시합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 마이그레이션 중에 감지된 데이터 손실이 심각한 경우 건너뛴 항목을 승인하지 않으면 마이그레이션을 완료할 수 없습니다. 항목이 원본 사서함에서 손상되어 대상 사서함에 복사할 수 없거나, 테넌트에 구성된 최대 허용 메시지 크기보다 크거나, 마이그레이션을 완료할 준비가 되었을 때 대상 사서함에서 누락된 것으로 감지되어 건너뛴 것일 수 있습니다.
최대 메시지 크기 값에 대한 자세한 내용은 Exchange Online 제한을 참조하세요.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AutoRetryCount
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
AutoRetryCount 매개 변수는 오류가 발생한 사서함을 마이그레이션하기 위해 마이그레이션 일괄 처리를 다시 시작하려고 시도하는 횟수를 지정합니다.
매개 변수 속성
| 형식: | Int32 |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-BadItemLimit
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
BadItemLimit 매개 변수는 마이그레이션 요청이 실패하기 전에 허용되는 잘못된 항목의 최대 수를 지정합니다. 잘못된 항목은 대상 사서함으로 복사할 수 없는 원본 사서함의 손상된 항목입니다. 또한 잘못된 항목 제한에는 누락된 항목도 포함됩니다. 누락된 항목은 마이그레이션 요청이 완료될 준비가 되면 대상 사서함에서 찾을 수 없는 원본 사서함의 항목입니다.
이 매개 변수에는 정수 또는 무제한 값을 입력할 수 있습니다. 기본값은 0입니다. 즉, 잘못된 항목이 검색되면 마이그레이션 요청이 실패합니다. 몇 가지 잘못된 항목을 남겨도 괜찮다면 이 매개 변수를 적절한 값(10 이하 권장)으로 설정하여 마이그레이션 요청을 진행할 수 있습니다. 잘못된 항목이 너무 많이 검색되면 New-MailboxRepairRequest cmdlet을 사용하여 원본 사서함의 손상된 항목 수정을 시도하고 마이그레이션 요청을 다시 시도합니다.
참고: 이 매개 변수는 클라우드 기반 서비스에서 더 이상 사용되지 않습니다. 관리자는 마이그레이션이 완료되기 전에 데이터 일관성 점수 와 건너뛴 항목을 검토해야 합니다.
매개 변수 속성
| 형식: | Unlimited |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-CompleteAfter
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
이 매개 변수는 클라우드 기반 서비스에서만 작동합니다.
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로 변환됩니다.
매개 변수 속성
| 형식: | DateTime |
| 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의 경우 값 없이 확인 스위치를 지정하면 일시 중지가 발생하여 계속하기 전에 명령을 승인해야 합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | CF |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-CSVData
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
CSVData 매개 변수는 이동하거나 마이그레이션할 사용자 사서함에 대한 정보가 들어 있는 CSV 파일을 지정합니다. CSV 파일의 헤더 행에 필요한 특성은 마이그레이션 유형에 따라 다릅니다.
이 매개 변수에 유효한 값을 사용하려면 다음 구문 ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))을 사용하여 파일을 바이트 인코딩된 개체로 읽어야 합니다. 이 명령을 매개 변수 값으로 사용하거나 출력을 변수($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>'))에 쓰고 변수를 매개 변수 값($data)으로 사용할 수 있습니다.
참고: 이 매개 변수는 RBAC scope에 따라 사서함의 가용성을 확인하지 않습니다. 사서함을 마이그레이션할 수 있는 관리자 권한을 부여하는 RBAC scope(예: OU) 밖에 있는 경우에도 CSV 파일에 지정된 모든 사서함이 마이그레이션됩니다.
매개 변수 속성
| 형식: | Byte[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(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 매개 변수는 수정할 마이그레이션 일괄 처리를 지정합니다. 마이그레이션 일괄 처리를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:
- 이름(Identity 속성 값)
- GUID(BatchGuid 속성 값)
매개 변수 속성
| 형식: | MigrationBatchIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 1 |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-LargeItemLimit
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
LargeItemLimit 매개 변수는 마이그레이션 요청이 실패하기 전에 허용되는 큰 항목의 최대 수를 지정합니다. 큰 항목은 대상 사서함에서 허용되는 최대 메시지 크기를 초과하는 원본 사서함의 메시지입니다. 대상 사서함에 특수하게 구성된 최대 메시지 크기 값이 지정되지 않은 경우 조직 전체의 값이 사용됩니다.
최대 메시지 크기 값에 대한 자세한 내용은 Exchange Server의 메시지 크기 제한을 참조하세요.
이 매개 변수에는 정수 또는 무제한 값을 입력할 수 있습니다. 기본값은 0입니다. 즉, 큰 항목이 검색되면 마이그레이션 요청이 실패합니다. 몇 개의 큰 항목을 남겨도 괜찮은 경우 이 매개 변수를 적절한 값(10 이하 권장)으로 설정하여 마이그레이션 요청을 진행할 수 있습니다.
참고: 이 매개 변수는 클라우드 기반 서비스에서 더 이상 사용되지 않습니다. 관리자는 마이그레이션이 완료되기 전에 데이터 일관성 점수 와 건너뛴 항목을 검토해야 합니다.
매개 변수 속성
| 형식: | Unlimited |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-MoveOptions
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
MoveOptions 매개 변수는 디버깅을 목적으로 건너뛰려는 마이그레이션 단계를 지정합니다. 이 매개 변수는 Microsoft 고객 서비스 및 지원이나 관련 설명서의 지시가 있는 경우가 아니라면 사용하지 마십시오.
SkipMoving 매개 변수와 함께 이 매개 변수를 사용하지 마십시오.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-NotificationEmails
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
NotificationEmails 매개 변수는 마이그레이션 상태 보고서를 보낼 대상 전자 메일 주소를 하나 이상 지정합니다.
이 매개 변수를 사용하지 않으면 상태 보고서가 전송되지 않습니다.
여러 값을 입력하고 기존 항목을 덮어쓰려면 다음 구문을 사용합니다. Value1,Value2,...ValueN 값에 공백이 포함되어 있거나 인용 부호가 필요하면 다음 구문을 사용합니다. "Value1","Value2",..."ValueN"
매개 변수 속성
| 형식: | 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 |
-ReportInterval
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
ReportInterval 매개 변수는 NotificationEmails에 나열된 전자 메일 주소로 전자 메일로 보고서를 보내는 빈도를 지정합니다.
기본적으로 전자 메일로 전송된 보고서는 일괄 처리에 대해 24시간마다 전송됩니다. 이 값을 0으로 설정하면 이 일괄 처리에 대한 보고서를 보내지 않아야 함을 나타냅니다.
이 매개 변수는 클라우드 기반 서비스에서만 사용해야 합니다.
매개 변수 속성
| 형식: | TimeSpan |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SkipMerging
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
SkipMerging 매개 변수는 디버깅을 목적으로 건너뛰려는 마이그레이션 단계를 지정합니다. 이 매개 변수는 Microsoft 고객 서비스 및 지원이나 관련 설명서의 지시가 있는 경우가 아니라면 사용하지 마십시오.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SkipMoving
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
이 매개 변수는 MoveOptions 매개 변수로 대체됩니다.
SkipMoving 매개 변수는 디버깅을 목적으로 건너뛰려는 마이그레이션 단계를 지정합니다. 이 매개 변수는 Microsoft 고객 서비스 및 지원이나 관련 설명서의 지시가 있는 경우가 아니라면 사용하지 마십시오.
매개 변수 속성
| 형식: | MultiValuedProperty |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SkipReports
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
SkipReports 스위치는 마이그레이션에 대한 자동 보고를 건너뛰도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SourcePublicFolderDatabase
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
SourcePublicFolderDatabase 매개 변수는 공용 폴더 마이그레이션에 사용되는 원본 공용 폴더 데이터베이스를 지정합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.
- 이름
- DN(고유 이름)
- GUID
매개 변수 속성
| 형식: | DatabaseIdParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-StartAfter
적용 가능: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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로 변환됩니다.
매개 변수 속성
| 형식: | DateTime |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SyncNow
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
SyncNow 스위치는 이미 동기화된 상태에 도달한 사용자에 대해 즉시 동기화를 시작하지만 실패한 사용자를 다시 시작하지 않습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치를 사용하여 이동이 완료되기 직전에 스위치를 사용하여 이동 온보딩 속도를 높일 수 있습니다. IMAP 마이그레이션의 경우 MX 레코드 전환 후에 이 스위치를 사용할 수 있습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Update
적용 가능: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
업데이트 스위치는 마이그레이션 일괄 처리에 업데이트 플래그를 설정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
업데이트 플래그는 엔드포인트, 일괄 처리 및 사용자의 모든 설정을 마이그레이션 프로세스에 다시 적용하도록 마이그레이션 서비스를 트리거합니다.
매개 변수 속성
| 형식: | 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 |
| 별칭: | wi |
매개 변수 집합
(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은 데이터를 반환하지 않습니다.