Get-MailboxRestoreRequest
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.
Use o cmdlet Get-MailboxRestoreRequest para exibir o status detalhado de uma solicitação de restauração em andamento que tenha sido iniciada usando o cmdlet New-MailboxRestoreRequest.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
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
Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.
Exemplos
Exemplo 1
Get-MailboxRestoreRequest -Identity "Ayla\MailboxRestore"Este exemplo retorna o status da solicitação de restauração em andamento e enfileirada com a identidade ayla\MailboxRestore, em que Ayla é o primeiro nome do usuário.
Exemplo 2
Get-MailboxRestoreRequest -TargetDatabase MBD01No Exchange Server 2010, este exemplo retorna o status de solicitações de restauração em andamento e enfileiradas que estão sendo restauradas no banco de dados de destino MBD01.
Exemplo 3
Get-MailboxRestoreRequest -RequestQueue MBD01Este exemplo retorna o status das solicitações de restauração em andamento e na fila que estão sendo restauradas para o banco de dados de caixa de correio MBD01.
Exemplo 4
Get-MailboxRestoreRequest -Name "RestoreToMBD01" -Suspend $trueEste exemplo retorna todas as solicitações de restauração que tiverem o nome RestoreToMBD01 em que a solicitação de restauração tenha sido suspensa.
Parâmetros
-BatchName
O parâmetro BatchName especifica o nome dado a um lote de solicitações de restauração.
Nome do banco de dados
| 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
Este parâmetro está disponível somente no Exchange local.
O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, 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
O parâmetro HighPriority filtra os resultados com base no valor prioritário atribuído quando a solicitação foi criada. A entrada válida para esse parâmetro é $true ou $false. Veja como esses valores filtram os resultados:
- $true Retorna solicitações que foram criadas com o valor de prioridade Alta, Superior, Mais Alta ou Emergência.
- $false Retorna solicitações que foram criadas com o valor de prioridade Normal, Baixo, Inferior ou Menor.
Nome do banco de dados
| 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
O parâmetro Identity especifica a identidade da solicitação da restauração. O parâmetro Identity consiste no alias da caixa de correio a ser restaurada e no nome que foi especificado quando a solicitação de restauração foi criada. A identidade da solicitação de restauração usa a seguinte sintaxe: Alias\Name.
Se você não especificou um nome para a solicitação de restauração quando ela foi criada, o Exchange gerou automaticamente o nome padrão MailboxRestore. O Exchange gera até 10 nomes, começando com MailboxRestore e, em seguida, MailboxRestoreX (onde X = 1-9).
Você não pode usar este parâmetro com o parâmetro 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
O parâmetro Name especifica que qualquer solicitação de restauração que possui o nome especificado seja retornada.
Use este parâmetro para pesquisar o nome que você forneceu ao criar a solicitação de restauração.
Se você não especificou um nome para a solicitação de restauração quando ela foi criada, o Exchange gerou automaticamente o nome padrão MailboxRestore. O Exchange gera até 10 nomes, começando com MailboxRestore e, em seguida, MailboxRestoreX (onde X = 1-9).
Nome do banco de dados
| 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
Este parâmetro está disponível somente no Exchange local.
O parâmetro RequestQueue identifica a solicitação com base no banco de dados da caixa de correio em que a solicitação está sendo executada. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Nome do banco de dados
| 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
O parâmetro ResultSize especifica o número máximo de resultados a serem retornados. Caso pretenda retornar todas as solicitações correspondentes à consulta, use unlimited como valor desse parâmetro. O valor padrão é 1000.
| 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
Este parâmetro está disponível somente no Exchange local.
O parâmetro SourceDatabase especifica se o cmdlet deve apenas retornar solicitações de restauração para caixas de correio que estejam sendo restauradas do banco de dados de origem especificado. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Nome do banco de dados
| 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
O parâmetro Status filtra os resultados com base no status. É possível usar os seguintes valores:
- AutoSuspended
- Concluído
- CompletedWithWarning
- Completioninprogress
- Falhou
- Inprogress
- Na fila
- Repetindo
- Suspenso
- Sincronizados
Nome do banco de dados
| 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
O parâmetro Suspend especifica se deve retornar solicitações que foram suspensas. A entrada válida para esse parâmetro é $true ou $false.
Nome do banco de dados
| 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
Esse parâmetro só está disponível no Exchange Server 2010.
O parâmetro TargetDatabase especifica que o cmdlet só deve retornar solicitações de restauração para caixas de correio que residem no banco de dados de destino. É possível usar qualquer valor que identifique o banco de dados com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- GUID
Nome do banco de dados
| Type: | DatabaseIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010 |
-TargetMailbox
O parâmetro TargetMailbox especifica a identidade da caixa de correio de destino. É possível usar os seguintes valores:
- GUID
- Nome diferenciado (DN)
- Domain\Account
- Nome principal do usuário (UPN)
- DN Herdado do Exchange
- Endereço SMTP
- Alias
Nome do banco de dados
| 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 |
Entradas
Input types
Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.
Saídas
Output types
Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.