Get-MailboxRestoreRequest
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 MBD012010년 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 매개 변수는 지정된 이름을 포함하는 모든 복원 요청이 반환되도록 지정합니다.
이 매개 변수를 사용하여 복원 요청을 만들 때 제공한 이름을 검색합니다.
복원 요청을 만들 때 이름을 지정하지 않으면 Exchange에서 기본 이름 MailboxRestore를 자동으로 생성했습니다. Exchange는 MailboxRestore 및 MailboxRestoreX(여기서 X = 1-9)로 시작하여 최대 10개의 이름을 생성합니다.
데이터베이스 이름
| 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은 데이터를 반환하지 않습니다.