Get-PublicFolderMailboxMigrationRequest

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

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

Sintaxe

Filtering

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

Identity

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 específico de migração de caixa de correio.
  • 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 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-PublicFolderMailboxMigrationRequest

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

Exemplo 2

Get-PublicFolderMailboxMigrationRequest -HighPriority $true

No Exchange local, esse exemplo retorna todas as solicitações de migração que têm um valor de prioridade de Alta, Alta, Máxima 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 duplicadas de migração de pasta pública (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

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

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

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

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
  • Alta prioridade
  • Nome
  • RequestQueue
  • Suspender
  • Status

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

-Name

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

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 é PublicFolderMailboxMigration<GUID> (por exemplo, PublicFolderMailboxMigration2ffdef13-01b9-4586-af2b-d5a5482010a8).

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

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

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

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

Propriedades do parâmetro

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

Conjuntos de parâmetros

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

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

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