Get-PublicFolderMailboxMigrationRequest

  • Referência
Módulo:
ExchangePowerShell
Aplica-se a:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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-PublicFolderMailboxMigrationRequest para exibir o status de trabalhos individuais em lotes de migração de pasta pública que foram criados usando o cmdlet New-MigrationBatch.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-PublicFolderMailboxMigrationRequest
   [-BatchName <String>]
   [-DomainController <Fqdn>]
   [-HighPriority <Boolean>]
   [-Name <String>]
   [-RequestQueue <DatabaseIdParameter>]
   [-ResultSize <Unlimited>]
   [-Status <RequestStatus>]
   [-Suspend <Boolean>]
   [<CommonParameters>]
Get-PublicFolderMailboxMigrationRequest
   [[-Identity] <PublicFolderMailboxMigrationRequestIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Description

Por padrão, o cmdlet Get-PublicFolderMailboxMigrationRequest exibe as seguintes propriedades.

  • Nome: o nome atribuído pelo sistema a um trabalho de migração de caixa de correio específico.
  • TargetMailbox: a caixa de correio que está sendo migrada.
  • Status: o status atual do trabalho.

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

Este exemplo retorna informações sobre todas as solicitações de migração.

Exemplo 2

Get-PublicFolderMailboxMigrationRequest -HighPriority $true

No Exchange local, este exemplo retorna todas as solicitações de migração que têm um valor prioritário de Alta, Superior, Mais Alta ou Emergência.

Exemplo 3

Get-PublicFolderMailboxMigrationRequest | ?{$_.TargetMailbox -eq $null}

Este exemplo retorna solicitações de migração de caixa de correio de pasta pública que não têm uma caixa de correio de destino.

Exemplo 4

Get-PublicFolderMailboxMigrationRequest | group TargetMailbox |?{$_.Count -gt 1}

Este exemplo retorna solicitações de migração de pasta pública duplicadas (solicitações criadas para a mesma caixa de correio de destino). Se o comando não retornar resultados, não haverá solicitações de migração duplicadas.

Parâmetros

-BatchName

O parâmetro BatchName filtra os resultados pelo valor amigável BatchName atribuído no momento da criação do trabalho em lotes. O formato desse valor é: MigrationService:<Batch name provided at batch creation>.

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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-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 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 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identity especifica a solicitação de migração de caixa de correio de pasta pública que você deseja exibir. O valor usa a sintaxe: \PublicFolderMailboxMigration<GUID> (por exemplo, \PublicFolderMailboxMigrationac6d9eb4-ee49-405f-b90d-04e9a258bd7e).

Você não pode usar este parâmetro com os seguintes parâmetros:

  • Batchname
  • HighPriority
  • Nome
  • RequestQueue
  • Suspender
  • Status
Type:PublicFolderMailboxMigrationRequestIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

O parâmetro Name especifica o nome da solicitação de migração de caixa de correio da pasta pública. Se o nome não foi especificado na criação, o valor padrão será PublicFolderMailboxMigration<GUID> (por exemplo, PublicFolderMailboxMigration2ffdef13-01b9-4586-af2b-d5a5482010a8).

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

Type:RequestStatus
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, 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 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online