Set-MigrationUser

이 cmdlet은 클라우드 기반 서비스에서만 작동합니다.

Set-MigrationUser cmdlet을 사용하여 기존 마이그레이션 일괄 처리에서 사용자의 마이그레이션 설정을 수정합니다.

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

Syntax

Set-MigrationUser
   [-Identity] <MigrationUserIdParameter>
   [-ApproveSkippedItems]
   [-BadItemLimit <Unlimited>]
   [-CompleteAfter <DateTime>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LargeItemLimit <Unlimited>]
   [-Partition <MailboxIdParameter>]
   [-StartAfter <DateTime>]
   [-SyncNow]
   [-WhatIf]
   [<CommonParameters>]

Description

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

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

예제

예 1

Set-MigrationUser -Identity laura@contoso.com -LargeItemLimit 15 -BadItemLimit 15

다음은 기존 마이그레이션 일괄 처리에서 사용자 laura@contoso.com 에 대한 큰 항목 제한 및 잘못된 항목 제한을 변경하는 예제입니다.

예 2

Set-MigrationUser -Identity laura@contoso.com -ApproveSkippedItems

이 예제에서는 기존 마이그레이션 일괄 처리에서 사용자 laura@contoso.com 에 대해 발생한 모든 건너뛴 항목을 승인합니다.

매개 변수

-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

-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 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로 지정합니다( 예: "2021-05-06 14:30:00z").
  • 날짜/시간 값을 현지 표준 시간대의 날짜/시간을 UTC로 변환하는 수식으로 지정합니다(예 (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(): ). 자세한 내용은 Get-Date를 참조하세요.
Type:DateTime
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 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 2016, Exchange Server 2019

-Identity

Identity 매개 변수는 마이그레이션 중인 사용자의 이메일 주소를 지정합니다.

Get-MigrationUser cmdlet의 출력에서 MigrationUser 속성의 GUID 값으로 사용자를 식별할 수도 있습니다. 이 식별 방법은 실수로 동일한 사용자를 여러 일괄 처리로 제출한 경우에 유용합니다.

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

-StartAfter

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

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

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

Exchange Online PowerShell에서 표준 시간대 없이 날짜/시간 값을 지정하면 값은 UTC(협정 세계시)에 있습니다.

이 매개 변수에 대한 날짜/시간값을 지정하려면 다음 옵션 중 하나를 사용하십시오.

  • 날짜/시간 값을 UTC로 지정합니다( 예: "2021-05-06 14:30:00z").
  • 날짜/시간 값을 현지 표준 시간대의 날짜/시간을 UTC로 변환하는 수식으로 지정합니다(예 (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(): ). 자세한 내용은 Get-Date를 참조하세요.
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SyncNow

SyncNow 스위치는 마이그레이션된 사용자에 대해 증분 동기화를 트리거할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

증분 동기화는 원본 사서함의 최근 변경 내용을 대상 사서함으로 복사합니다. 마이그레이션 일괄 처리를 완료하기 전에 증분 동기화를 수행하여 완료에 필요한 시간을 줄일 수 있습니다.

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