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.

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-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, 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-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 retorna o status de solicitações de exportação em andamento para caixas de correio ou arquivos mortos que residem no banco 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 retorna todas as solicitações de exportação que têm o nome DB01toPST onde 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

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

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

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 padrão, as solicitações de exportação são nomeadas <alias>\MailboxExportX (em que X = 0-9). Se você especificou um nome para a solicitação de exportação quando a solicitação foi criada usando o cmdlet New-MailboxExportRequest, use a seguinte sintaxe: Alias\Name O Exchange precede automaticamente a solicitação 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
  • 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: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 Mailbox filtra os resultados pela caixa de correio de origem de onde o conteúdo está sendo exportado.

No Exchange 2016 CU7 ou posterior, esse parâmetro é do 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 é do tipo MailboxOrMailUserIdParameter, portanto, você pode usar qualquer valor que identifique exclusivamente a caixa de correio. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domínio\Nome de usuário
  • 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 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

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

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

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.