Get-MailboxRestoreRequest

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Get-MailboxRestoreRequest cmdlet을 사용하여 New-MailboxRestoreRequest cmdlet을 사용하여 시작된 진행 중인 복원 요청의 자세한 상태를 볼 수 있습니다.

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

Syntax

Get-MailboxRestoreRequest
   [[-Identity] <MailboxRestoreRequestIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Get-MailboxRestoreRequest
   [-BatchName <String>]
   [-HighPriority <Boolean>]
   [-Name <String>]
   [-RequestQueue <DatabaseIdParameter>]
   [-SourceDatabase <DatabaseIdParameter>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [-TargetDatabase <DatabaseIdParameter>]
   [-TargetMailbox <MailboxOrMailUserIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

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

예제

예 1

Get-MailboxRestoreRequest -Identity "Ayla\MailboxRestore"

이 예제에서는 Ayla\MailboxRestore ID를 사용하여 진행 중인 복원 요청 및 대기 중인 복원 요청의 상태를 반환합니다. 여기서 Ayla는 사용자의 이름입니다.

예 2

Get-MailboxRestoreRequest -TargetDatabase MBD01

2010년 Exchange Server 이 예제에서는 대상 데이터베이스 MBD01로 복원되는 진행 중인 복원 요청 및 대기 중인 복원 요청의 상태를 반환합니다.

예 3

Get-MailboxRestoreRequest -RequestQueue MBD01

이 예제에서는 사서함 데이터베이스 MBD01로 복원되는 진행 중인 복원 요청 및 대기 중인 복원 요청의 상태를 반환합니다.

예 4

Get-MailboxRestoreRequest -Name "RestoreToMBD01" -Suspend $true

이 예제에서는 복원 요청이 일시 중단된 RestoreToMBD01이라는 이름의 모든 복원 요청을 반환합니다.

매개 변수

-BatchName

BatchName 매개 변수는 복원 요청 일괄 처리에 지정된 이름을 지정합니다.

데이터베이스 이름

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, 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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-HighPriority

HighPriority 매개 변수는 요청을 만들 때 할당된 우선 순위 값에 따라 결과를 필터링합니다. 이 매개 변수에는 $true 또는 $false을 입력할 수 있습니다. 이러한 값이 결과를 필터링하는 방법은 다음과 같습니다.

$true 우선 순위 값 높음, 높음, 가장 높음 또는 긴급으로 만든 요청을 반환합니다.
$false 우선 순위 값 Normal, Low, Lower 또는 Low로 만든 요청을 반환합니다.

데이터베이스 이름

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

-Identity

Identity 매개 변수는 복원 요청의 ID를 지정합니다. Identity 매개 변수는 복원할 사서함의 별칭과 복원 요청을 만들 때 지정된 이름으로 구성됩니다. 복원 요청의 ID는 구문을 Alias\Name사용합니다.

복원 요청을 만들 때 이름을 지정하지 않으면 Exchange에서 기본 이름 MailboxRestore를 자동으로 생성했습니다. Exchange는 MailboxRestore 및 MailboxRestoreX(여기서 X = 1-9)로 시작하여 최대 10개의 이름을 생성합니다.

Name 매개 변수에는 이 매개 변수를 사용할 수 없습니다.

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

-Name

Name 매개 변수는 지정된 이름을 포함하는 모든 복원 요청이 반환되도록 지정합니다.

이 매개 변수를 사용하여 복원 요청을 만들 때 제공한 이름을 검색합니다.

데이터베이스 이름

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

-RequestQueue

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

RequestQueue 매개 변수는 요청이 실행되는 사서함 데이터베이스를 기반으로 요청을 식별합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

이름
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

-ResultSize

ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1,000입니다.

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

-SourceDatabase

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

SourceDatabase 매개 변수는 cmdlet이 지정된 원본 데이터베이스에서 복원되는 사서함에 대한 복원 요청만 반환해야 한다고 지정합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

이름
DN(고유 이름)
GUID

데이터베이스 이름

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

-Status

Status 매개 변수는 상태에 따라 결과를 필터링합니다. 다음 값을 사용할 수 있습니다.

AutoSuspended
완료
CompletedWithWarning
CompletionInProgress
실패
Inprogress
대기
재시도
일시 중단됨
동기화됨

데이터베이스 이름

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

-Suspend

Suspend 매개 변수는 일시 중단된 요청을 반환할지 여부를 지정합니다. 이 매개 변수에는 $true 또는 $false을 입력할 수 있습니다.

데이터베이스 이름

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

-TargetDatabase

이 매개 변수는 Exchange Server 2010에서만 사용할 수 있습니다.

TargetDatabase 매개 변수는 cmdlet이 대상 데이터베이스에 있는 사서함에 대한 복원 요청만 반환해야 함을 지정합니다. 데이터베이스를 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

이름
DN(고유 이름)
GUID

데이터베이스 이름

Type:	DatabaseIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010

-TargetMailbox

TargetMailbox 매개 변수는 대상 사서함의 ID를 지정합니다. 다음 값을 사용할 수 있습니다.

GUID
DN(고유 이름)
Domain\Account
UPN(사용자 계정 이름)
레거시 Exchange DN
SMTP 주소
별칭

데이터베이스 이름

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

입력

Input types

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

출력

Output types

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

Get-MailboxRestoreRequest

Syntax

Description

예제

예 1

예 2

예 3

예 4

매개 변수

-BatchName

-DomainController

-HighPriority

-Identity

-Name

-RequestQueue

-ResultSize

-SourceDatabase

-Status

-Suspend

-TargetDatabase

-TargetMailbox

입력

출력

피드백

피드백

추가 리소스