Get-MailboxImportRequest
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-MailboxImportRequest para exibir o status detalhado de uma solicitação de importação em andamento que tenha sido iniciada usando o cmdlet New-MailboxImportRequest.
Esse cmdlet está disponível apenas na função Exportação de Importação de Caixa de Correio e, por padrão, a função não é atribuída a nenhum grupo de funções. Para usar esse cmdlet, você precisa adicionar a função Exportação de Importação de Caixa de Correio a um grupo de funções (por exemplo, ao grupo de funções gerenciamento de organização). Para obter mais informações, consulte Adicionar uma função a um grupo de funções.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
Get-MailboxImportRequest
[[-Identity] <MailboxImportRequestIdParameter>]
[-DomainController <Fqdn>]
[-ResultSize <Unlimited>]
[<CommonParameters>] Get-MailboxImportRequest
[-BatchName <String>]
[-Database <DatabaseIdParameter>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-Mailbox <MailboxOrMailUserIdParameter>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[-RequestQueue <DatabaseIdParameter>]
[<CommonParameters>] Get-MailboxImportRequest
[-BatchName <String>]
[-Database <DatabaseIdParameter>]
[-DomainController <Fqdn>]
[-HighPriority <Boolean>]
[-Mailbox <MailboxLocationIdParameter>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-Status <RequestStatus>]
[-Suspend <Boolean>]
[-RequestQueue <DatabaseIdParameter>]
[<CommonParameters>] Description
O critério de pesquisa para o cmdlet Get-MailboxImportRequest é uma declaração And booleana. Ao usar parâmetros múltiplos, a pesquisa é restrita e reduz os resultados da pesquisa.
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-MailboxImportRequest -Identity "tony\Recovered"Este exemplo devolve as informações padrão quanto ao status da solicitação de importação em andamento com a identidade tony\Recovered. O tipo das informações retornadas por padrão, inclui nome, caixa de correio e status.
Exemplo 2
Get-MailboxImportRequest -Status InProgress -Database DB01Em Exchange Server 2010, este exemplo retorna o status de solicitações de importação em andamento para caixas de correio ou arquivos que residem no banco de dados DB01.
Exemplo 3
Get-MailboxImportRequest -BatchName "ImportingDB1PSTs" -Status CompletedEste exemplo devolve o status das solicitações de importação no lote ImportingDB1PSTs que concluiu.
Exemplo 4
Get-MailboxImportRequest -Name "Recovered" -Suspend $trueEste exemplo devolve todas as solicitações de importação que tiveram o nome Recuperado onde a importação foi suspensa.
Parâmetros
-BatchName
O parâmetro BatchName especifica o nome dado a uma solicitação de importação em lote.
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 |
-Database
Esse parâmetro só está disponível no Exchange Server 2010.
O parâmetro Banco de Dados especifica o banco de dados no qual reside a caixa de correio ou o arquivo do usuário. É 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 |
-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
Este parâmetro está disponível somente no Exchange local.
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 |
-Identity
O parâmetro Identity especifica a identidade da solicitação da importação. Por padrão, as solicitações de importação são nomeadas <alias>\MailboxImportX (em que X = 0-9). Se você especificar um nome para a solicitação de importação, use a seguinte sintaxe: Alias\Name. Microsoft Exchange precede automaticamente a solicitação com o alias da caixa de correio.
Você não pode usar este parâmetro com os seguintes parâmetros:
- Batchname
- Mailbox
- Nome
- Status
- Suspender
- HighPriority
| Type: | MailboxImportRequestIdParameter |
| 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 |
-Mailbox
Esse parâmetro é funcional apenas no Exchange local.
O parâmetro Caixa de correio filtra os resultados pela caixa de correio de destino para a qual o conteúdo está sendo importado.
No Exchange 2016 CU7 ou posterior, esse parâmetro é o tipo MailboxLocationIdParameter, portanto, o valor mais fácil que você pode usar para identificar a caixa de correio é o valor Alias.
No Exchange 2016 CU6 ou anterior, esse parâmetro é o tipo MailboxOrMailUserIdParameter, para que você possa usar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domain\username
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
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 |
-Name
O parâmetro Name especifica que a solicitação de importação que teve o nome especificado é devolvida.
Use este parâmetro para pesquisar o nome que você forneceu ao criar a solicitação de importação. Se você não especificou um nome quando a solicitação foi criada, o nome padrão é MailboxImportX (onde X = 0-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 |
-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
CompletionInProgress e AutoSuspended não se aplicam às solicitações de importação e não devolvem nenhuma informação.
| 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 |
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.