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 ambiente ou de outro.
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.
Sintaxe
Identity
Get-MailboxRestoreRequest
[[-Identity] <MailboxRestoreRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Filtering
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 artigo 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 na fila com a identidade ayla\MailboxRestore, onde Ayla é o primeiro nome do usuário.
Exemplo 2
Get-MailboxRestoreRequest -TargetDatabase MBD01
No Exchange Server 2010, esse exemplo retorna o status de solicitações de restauração em andamento e enfileiradas que estão sendo restauradas para o banco de dados de destino MBD01.
Exemplo 3
Get-MailboxRestoreRequest -RequestQueue MBD01
Este 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 $true
Este exemplo retorna todas as solicitações de restauração que têm o nome RestoreToMBD01 em que a solicitação de restauração está suspensa.
Parâmetros
-BatchName
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro BatchName especifica o nome dado a um lote de solicitações de restauração.
Nome do banco de dados
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Filtering
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-HighPriority
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro HighPriority filtra os resultados com base no valor Priority que foi 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, Alta, Mais alta ou Emergência.
- $false Retorna solicitações que foram criadas com o valor de prioridade Normal, Baixa, Inferior ou Baixa.
Nome do banco de dados
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Filtering
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 (em que X = 1-9).
Você não pode usar este parâmetro com o parâmetro Name.
Cuidado: O valor $null ou um valor inexistente para o parâmetro Identity retorna todos os objetos como se você tivesse executado o comando Get- sem o parâmetro Identity. Verifique se todas as listas de valores para o parâmetro Identity são precisas e não contêm valores de $null inexistentes.
Propriedades do parâmetro
| Tipo: | MailboxRestoreRequestIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Name
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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 (em que X = 1-9).
Nome do banco de dados
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Filtering
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RequestQueue
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Este parâmetro está disponível somente no Exchange local.
O parâmetro RequestQueue identifica a solicitação com base no banco de dados de 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
Propriedades do parâmetro
| Tipo: | DatabaseIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Filtering
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ResultSize
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SourceDatabase
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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
Propriedades do parâmetro
| Tipo: | DatabaseIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Filtering
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Status
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Status filtra os resultados com base no status. É possível usar os seguintes valores:
- AutoSuspenso
- Concluído
- CompletedWithWarning
- CompletionInProgress
- Falhou
- Em andamento
- Na fila
- Tentando novamente
- Suspenso
- Sincronizados
Nome do banco de dados
Propriedades do parâmetro
| Tipo: | RequestStatus |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Filtering
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Suspend
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Suspend especifica se as solicitações que foram suspensas devem ser retornadas. A entrada válida para esse parâmetro é $true ou $false.
Nome do banco de dados
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Filtering
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TargetDatabase
Aplicável: 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
Propriedades do parâmetro
| Tipo: | DatabaseIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Filtering
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-TargetMailbox
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro TargetMailbox especifica a identidade da caixa de correio de destino. É possível usar os seguintes valores:
- GUID
- Nome diferenciado (DN)
- Domínio\Conta
- Nome principal do usuário (UPN)
- DN Herdado do Exchange
- Endereço SMTP
- Alias
Nome do banco de dados
Propriedades do parâmetro
| Tipo: | MailboxOrMailUserIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Filtering
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.