Set-MoveRequest

AcceptLargeDataLoss 스위치는 원본 사서함에서 많은 수의 항목을 대상 사서함으로 복사할 수 없더라도 요청이 계속되도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

Exchange 2013 이상 또는 Exchange Online에서는 LargeItemLimit 매개 변수를 51 이상의 값으로 설정 하는 경우에 이 스위치를 사용 해야 합니다. 그렇지 않은 경우 명령이 실패합니다.

Exchange 2010에서 BadItemLimit 매개 변수를 51 이상의 값으로 설정하는 경우 이 스위치를 사용해야 합니다. 그렇지 않은 경우 명령이 실패합니다.

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

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

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

이동 요청의 MoveStatus 값이 Queued인 경우에만 이 매개 변수를 사용하여 대상 데이터베이스를 변경할 수 있습니다.

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

이 매개 변수에는 정수 또는 무제한 값을 입력할 수 있습니다. 기본값은 0입니다. 이 경우 잘못된 항목이 발견되면 요청이 실패합니다. 잘못된 항목을 몇 개 남겨두어도 괜찮으면 요청이 계속될 수 있게 이 매개 변수를 적절한 값(권장 값: 10 이하)으로 설정할 수 있습니다. 잘못된 항목이 너무 많이 발견되면 New-MailboxRepairRequest cmdlet을 사용하여 원본 사서함의 손상된 항목을 수정하고 요청을 다시 시도합니다.

Exchange 2010에서 이 값을 51보다 크게 설정하면 AcceptLargeDataLoss 스위치도 사용해야 합니다. 그렇지 않은 경우 명령이 실패합니다.

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

BatchName 매개 변수는 배치에 대한 다른 이름을 지정합니다.

CompleteAfter 매개 변수는 요청이 완료되기까지의 지연을 지정합니다. 요청은 시작되지만 이 매개 변수로 지정한 날짜/시간까지 완료되지 않습니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 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를 참조하세요.

CompletedRequestAgeLimit 매개 변수는 요청이 완료된 후 자동으로 제거되기 전까지 유지되는 기간을 지정합니다. CompletedRequestAgeLimit 매개 변수의 기본값은 30일입니다.

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

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

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

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

Identity 매개 변수는 사서함 또는 메일 사용자의 ID를 지정합니다. 다음 값을 사용할 수 있습니다.

• GUID
• DN(고유 이름)
• Domain\Account
• UPN(사용자 계정 이름)
• LegacyExchangeDN
• SMTP 주소
• 별칭

IgnoreRuleLimitErrors 매개 변수는 명령이 사용자의 규칙을 Microsoft Exchange를 실행하는 대상 서버로 이동하지 않도록 지정합니다.

IncrementalSyncInterval 매개 변수는 증분 동기화 작업 사이 대기 시간을 지정합니다. 이 매개 변수는 CompleteAfter 매개 변수와 함께 사용되어 초기 동기화가 완료되면 주기적인 증분 동기화를 수행하는 이동 요청을 만듭니다.

값을 지정하려면 시간 범위로 입력합니다. dd.hh:mm:ss 여기서 dd = 일, hh = 시, mm = 분 및 ss = 초입니다.

유효한 값은 00:00:00에서 120.00:00:00(120일)입니다. 기본값은 24시간입니다.

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

InternalFlags 매개 변수는 요청의 선택적 단계를 지정합니다. 이 매개 변수는 기본적으로 디버깅 목적으로 사용됩니다.

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

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

• Exchange 2016: Exchange Server 메시지 크기 제한
• Exchange Online: Exchange Online 제한

이 매개 변수에는 정수 또는 무제한 값을 입력할 수 있습니다. 기본값은 0입니다. 이 경우 큰 항목이 발견되면 요청이 실패합니다. 큰 항목을 몇 개 남겨두어도 괜찮으면 요청이 계속될 수 있게 이 매개 변수를 적절한 값(권장 값: 10 이하)으로 설정할 수 있습니다.

이 값을 51보다 크게 설정하면 AcceptLargeDataLoss 스위치도 사용해야 합니다. 그렇지 않은 경우 명령이 실패합니다.

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

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

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

PreventCompletion 매개 변수는 이동 요청을 실행하지만 완료를 허용하지 않을지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

• $true: 이동 요청이 실행되지만 완료할 수 없습니다. 이 값 대신 CompleteAfter 매개 변수를 사용하는 것이 좋습니다.
• $false: 기본값입니다. 이동 요청이 실행되고 완료할 수 있습니다. SuspendWhenReadyToComplete 또는 PreventCompletion 스위치를 사용하여 이동 요청을 만든 경우 Resume-MoveRequest cmdlet을 실행하여 이동 요청을 완료하기 전에 이 매개 변수를 $false 설정합니다.

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

Priority 매개 변수는 요청 큐에서 이 요청의 처리 순서를 지정합니다. 요청은 서버 상태, 상태, 우선 순위 및 마지막 업데이트 시간을 기준으로 순서대로 처리됩니다. 유효한 우선 순위 값은 다음과 같습니다.

• 가장 낮음
• 더 낮음
• 낮음
• 보통: 기본 값
• 높음
• 더 높음
• 가장 높음
• 긴급

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

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

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

ProxyToMailbox 매개 변수는 지정된 사서함의 위치에서 이동 위치를 지정합니다(Proxing이라고도 함). 사서함을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예:

• 이름
• 별칭
• DN(고유 이름)
• DN(고유 이름)
• Domain\Username
• 전자 메일 주소
• GUID
• LegacyExchangeDN
• SamAccountName
• 사용자 ID 또는 UPN(사용자 계정 이름)

RemoteCredential 매개 변수는 사서함 이동을 수행할 수 있는 권한이 있는 관리자의 사용자 이름 및 암호를 지정합니다.

이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.

RemoteGlobalCatalog 매개 변수는 원격 포리스트에 대한 글로벌 카탈로그 서버의 FQDN을 지정합니다.

RemoteHostName 매개 변수는 사서함을 이동하는 크로스 포리스트 조직의 FQDN을 지정합니다.

RequestExpiryInterval 매개 변수는 완료되었거나 실패한 요청에 대한 보존 기간을 지정합니다. 이 매개 변수를 사용하면 지정된 간격이 만료된 후에 완료되었거나 실패한 요청이 자동으로 제거됩니다. 이 매개 변수를 사용하지 않는 경우:

• 완료된 요청이 CompletedRequestAgeLimit 매개 변수 값에 따라 자동으로 제거됩니다.
• 요청이 실패하면 해당 Remove-*Request cmdlet을 사용하여 수동으로 제거해야 합니다.

값을 지정하려면 시간 범위로 입력합니다. dd.hh:mm:ss 여기서 dd = 일, hh = 시, mm = 분 및 ss = 초입니다.

무제한 값을 사용하면 완료된 요청이 자동으로 제거되지 않습니다.

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

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

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

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

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

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

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

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

{{ 채우기 SourceEndpoint Description }}

StartAfter 매개 변수는 요청이 시작되기까지의 시간 지연을 지정합니다. 이 매개 변수에 지정된 날짜/시간까지 요청은 시작되지 않습니다.

명령이 실행되는 컴퓨터 구성에 설정된 국가별 옵션에 정의되어 있는 간단한 날짜 형식을 사용합니다. 예를 들어 컴퓨터가 짧은 날짜 형식 MM/dd/yyyy를 사용하도록 구성된 경우 2018년 9월 1일을 지정하려면 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를 참조하세요.

SuspendWhenReadyToComplete 매개 변수는 이동 요청이 CompletionInProgress 상태가 되기 전에 일시 중단할지 여부를 지정합니다. 이 매개 변수 대신 CompleteAfter 매개 변수를 사용하는 것이 좋습니다.

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

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

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

이동 요청의 MoveStatus 값이 Queued인 경우에만 이 매개 변수를 사용하여 대상 데이터베이스를 변경할 수 있습니다.

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