Partilhar via

Get-MailboxImportRequest

Módulo:
Exchange PowerShell

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-MailboxImportRequest para exibir o status detalhado de uma solicitação de importação em andamento que tenha sido iniciada usando o cmdlet New-MailboxImportRequest.

Este cmdlet só está disponível na função Importar Exportação da Caixa de Correio e, por predefinição, a função não está atribuída a nenhum grupo de funções. Para utilizar este cmdlet, tem de adicionar a função Importar Exportação da Caixa de Correio a um grupo de funções (por exemplo, ao grupo de funções Gestão da Organização). Para obter mais informações, veja 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.

Sintaxe

Identity 

Get-MailboxImportRequest
    [[-Identity] <MailboxImportRequestIdParameter>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Filtering 

Get-MailboxImportRequest
    [-Mailbox <MailboxLocationIdParameter>]
    [-BatchName <String>]
    [-Database <DatabaseIdParameter>]
    [-DomainController <Fqdn>]
    [-HighPriority <Boolean>]
    [-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 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-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 DB01

No Exchange Server 2010, este exemplo devolve a status de pedidos de importação em curso para caixas de correio ou arquivos que residem na base de dados DB01.

Exemplo 3

Get-MailboxImportRequest -BatchName "ImportingDB1PSTs" -Status Completed

Este exemplo devolve o status das solicitações de importação no lote ImportingDB1PSTs que concluiu.

Exemplo 4

Get-MailboxImportRequest -Name "Recovered" -Suspend $true

Este exemplo devolve todos os pedidos de importação que têm o nome Recuperado onde a importaçã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 uma solicitação de importação em lote.

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

MailboxFiltering
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
MailboxLocationFiltering
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Database

Aplicável: Exchange Server 2010

Esse parâmetro está disponível somente no Exchange Server 2010.

O parâmetro Base de Dados especifica a base de dados na qual reside a caixa de correio ou o arquivo do utilizador. É 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

MailboxFiltering
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
MailboxLocationFiltering
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

Este parâmetro está disponível somente no Exchange local.

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

MailboxFiltering
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
MailboxLocationFiltering
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 importação. Por predefinição, os pedidos de importação têm o nome <alias>\MailboxImportX (em que X = 0-9). Se especificar um nome para o pedido de importação, utilize a seguinte sintaxe: Alias\Name. O Microsoft Exchange precede automaticamente o pedido 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
  • AltaPrioridade

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:MailboxImportRequestIdParameter
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

-Mailbox

Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Este parâmetro só é funcional 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á a ser importado.

No Exchange 2016 CU7 ou posterior, o tipo de parâmetro é MailboxLocationIdParameter. O valor Alias é a forma mais fácil de identificar a caixa de correio.

Nome do banco de dados

Sugestão: no Exchange 2016 CU6 ou anterior, o tipo de parâmetro era MailboxOrMailUserIdParameter. Pode utilizar qualquer valor que identificasse exclusivamente a caixa de correio (incluindo Alias).

Propriedades do parâmetro

Tipo:MailboxLocationIdParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

MailboxLocationFiltering
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
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 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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

MailboxFiltering
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
MailboxLocationFiltering
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

MailboxFiltering
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
MailboxLocationFiltering
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

-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

CompletionInProgress e AutoSuspended não se aplicam a pedidos de importação e não devolvem informações.

Propriedades do parâmetro

Tipo:RequestStatus
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

MailboxFiltering
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
MailboxLocationFiltering
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

MailboxFiltering
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
MailboxLocationFiltering
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.