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 configurações podem ser exclusivos de um ambiente ou de 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.

Esse cmdlet está disponível apenas na função Exportação Importação da 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 Importação da Caixa de Correio a um grupo de funções (por exemplo, para o grupo de funções Gerenciamento da 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.

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, 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 DB01

No Exchange Server 2010, este exemplo retorna o status de solicitações de importação em andamento para caixas de correio ou arquivos mortos que residem no banco 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 retorna todas as solicitações de importação que têm o nome Recovered em que a importação está 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

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

O parâmetro Database especifica o banco de dados no qual a caixa de correio ou o arquivo morto do usuário reside. É 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

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

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

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

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. O 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
Alta prioridade

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

Este parâmetro só é funcional no Exchange local.

O parâmetro Mailbox filtra os resultados pela caixa de correio de destino para a qual o conteúdo está sendo importado.

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

Nome do banco de dados

Dica: No Exchange 2016 CU6 ou anterior, o tipo de parâmetro era MailboxOrMailUserIdParameter. Você pode usar qualquer valor que identifique 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

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

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

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

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

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

CompletionInProgress e AutoSuspended não se aplicam a solicitações de importação e não retornam nenhuma informação.

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

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

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 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.

Comentários

Esta página foi útil?