Get-MailboxRestoreRequest
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou 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, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 devolve a status do pedido de restauro em curso e em fila com a identidade ayla\MailboxRestore, em que Ayla é o primeiro nome do utilizador.
Exemplo 2
Get-MailboxRestoreRequest -TargetDatabase MBD01
No Exchange Server 2010, este exemplo devolve a status de pedidos de restauro em curso e em fila que estão a ser restaurados para a base 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 devolve todos os pedidos de restauro que têm o nome RestoreToMBD01 em que o pedido de restauro está suspenso.
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 o pedido foi criado. A entrada válida para esse parâmetro é $true ou $false. Eis como estes valores filtram os resultados:
- $true Devolve pedidos que foram criados com o valor Prioridade Alta, Superior, Mais Alta ou Emergência.
- $false Devolve pedidos que foram criados com o valor Prioridade Normal, Baixo, Mais Baixo ou Mais Baixo.
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 do pedido de restauro utiliza a seguinte sintaxe: Alias\Name.
Se não especificou um nome para o pedido de restauro quando foi criado, o Exchange gerou automaticamente o nome predefinido 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.
Atenção: o valor $null ou um valor inexistente para o parâmetro Identidade devolve todos os objetos como se tivesse executado o comando Get- sem o parâmetro Identity. Verifique se as listas de valores do parâmetro Identity estão corretas 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 não especificou um nome para o pedido de restauro quando foi criado, o Exchange gerou automaticamente o nome predefinido 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 o pedido com base na base de dados da caixa de correio onde o pedido está a ser executado. É 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 Estado filtra os resultados com base no status. É possível usar os seguintes valores:
- AutoSuspended
- Concluído
- CompletedWithWarning
- CompletionInProgress
- Falhou
- Entrada
- Na fila
- A tentar 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 Suspender especifica se pretende devolver pedidos que tenham sido suspensos. 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
Esse parâmetro está disponível somente no Exchange Server 2010.
O parâmetro TargetDatabase especifica que o cmdlet só deve devolver pedidos de restauro para caixas de correio que residem na base 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 suporta os 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.