Partilhar via

Get-MailboxExportRequest

Módulo:
Exchange PowerShell

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Get-MailboxExportRequest para exibir o status detalhado de uma solicitação da exportação em andamento que tenha sido iniciada usando o cmdlet New-MailboxExportRequest.

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-MailboxExportRequest
    [[-Identity] <MailboxExportRequestIdParameter>]
    [-DomainController <Fqdn>]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

MailboxFiltering 

Get-MailboxExportRequest
    [-Mailbox <MailboxOrMailUserIdParameter>]
    [-BatchName <String>]
    [-Database <DatabaseIdParameter>]
    [-DomainController <Fqdn>]
    [-HighPriority <Boolean>]
    [-Name <String>]
    [-ResultSize <Unlimited>]
    [-Status <RequestStatus>]
    [-Suspend <Boolean>]
    [-RequestQueue <DatabaseIdParameter>]
    [<CommonParameters>]

MailboxLocationFiltering 

Get-MailboxExportRequest
    [-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-MailboxExportRequest é 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-MailboxExportRequest -Identity "tony\DB01toPST"

Este exemplo devolve o status do solicitação de exportação em andamento com a identidade tony\DB01toPST.

Exemplo 2

Get-MailboxExportRequest -Status InProgress -Database DB01

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

Exemplo 3

Get-MailboxExportRequest -BatchName "Attachment_CompanyReport" -Status Completed

Este exemplo devolve o status das solicitações de exportação no lote Attachment_CompanyReport que foi concluído.

Exemplo 4

Get-MailboxExportRequest -Name "DB01toPST" -Suspend $true

Este exemplo devolve todos os pedidos de exportação que têm o nome DB01toPST em que a exportação está suspensa.

Parâmetros

-BatchName

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

O parâmetro BatchName especifica o nome dado a uma solicitação de exportaçã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

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

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

O parâmetro Identity especifica a identidade da solicitação da exportação. Por predefinição, os pedidos de exportação têm o nome <alias>\MailboxExportX (em que X = 0-9). Se especificou um nome para o pedido de exportação quando o pedido foi criado com o cmdlet New-MailboxExportRequest, utilize a seguinte sintaxe: Alias\Name. O Exchange precede automaticamente o pedido com o alias da caixa de correio.

Esse parâmetro não pode ser usado 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:MailboxExportRequestIdParameter
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

O parâmetro Caixa de Correio filtra os resultados pela caixa de correio de origem a partir da qual os conteúdos estão a ser exportados.

No Exchange 2016 CU7 ou posterior, este parâmetro é o tipo MailboxLocationIdParameter, pelo que o valor mais fácil que pode utilizar para identificar a caixa de correio é o valor Alias.

No Exchange 2016 CU6 ou anterior, este parâmetro é o tipo MailboxOrMailUserIdParameter, pelo que pode utilizar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domínio\Nome de Utilizador
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

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

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

-Name

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

O parâmetro Name especifica que a solicitação de exportação que teve o nome especificado é devolvida.

Use este parâmetro para pesquisar o nome que você forneceu ao criar a solicitação de exportação.

Se você não especificou um nome quando a solicitação foi criada, o nome padrão é MailboxExportX (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

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

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

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 exportaçã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

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.