New-PublicFolderMoveRequest

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

Use o cmdlet New-PublicFolderMoveRequest para iniciar o processo de mover o conteúdo de pasta pública entre caixas de correio de pasta pública. Mover pastas públicas só move o conteúdo físico da pasta pública; não altera a hierarquia lógica. Quando a solicitação de movimentação for concluída, você deve executar o cmdlet Remove-PublicFolderMoveRequest para remover a solicitação ou esperar até o tempo especificado no parâmetro CompletedRequestAgeLimit passar. A solicitação deve ser removida antes de você executar outra solicitação de movimentação.

Lembre-se de que a caixa de correio de pasta pública de destino será bloqueada enquanto a solicitação de movimentação estiver ativa. Para obter mais informações, confira a seção Descrição.

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

Syntax

New-PublicFolderMoveRequest
   -Folders <PublicFolderIdParameter[]>
   -TargetMailbox <MailboxIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLargeItems]
   [-BadItemLimit <Unlimited>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-Suspend]
   [-SuspendComment <String>]
   [-SuspendWhenReadyToComplete]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

Description

O cmdlet New-PublicFolderMoveRequest move pastas públicas a partir de uma caixa de correio de pasta pública de origem para uma caixa de correio de pasta pública de destino. Enquanto a solicitação de movimentação estiver ativa, a caixa de correio de pasta pública de destino será bloqueada. Como resultado, as pastas públicas já residentes na caixa de correio de pasta pública de destino ficarão inacessíveis até a conclusão da solicitação de movimentação ser concluída. Portanto, antes de iniciar a solicitação de movimentação, você deve garantir que nenhum usuário esteja acessando dados de pasta pública nessa caixa de correio de pasta pública de destino.

Para mover a caixa de correio de pasta pública para outro banco de dados de caixa de correio, use o cmdlet New-MoveRequest. Para assegurar que esta pasta já esteja na caixa de correio de pasta pública de destino, execute o cmdlet Update-PublicFolderMailbox em relação à caixa de correio de pasta pública de destino. Você pode realizar apenas uma solicitação de movimentação por vez. Você também pode mover as pastas públicas usando o script Move-PublicFolderBranch.ps1.

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

New-PublicFolderMoveRequest -Folders \DeveloperReports\CustomerEngagements -TargetMailbox DeveloperReports01

Este exemplo inicia a solicitação de movimentação da pasta pública \CustomerEngagements da caixa de correio de pasta pública DeveloperReports para DeveloperReports01.

Exemplo 2

New-PublicFolderMoveRequest -Folders \Dev\CustomerEngagements,\Dev\RequestsforChange,\Dev\Usability -TargetMailbox DeveloperReports01

Este exemplo inicia a solicitação de movimentação das pastas públicas na ramificação de pastas públicas \Dev até a caixa de correio de pastas públicas de destino DeveloperReports01.

Você também pode mover uma ramificação de pastas públicas usando o script Move-PublicFolderBranch.ps1.

Exemplo 3

$folders = Get-PublicFolder \ -Recurse -Mailbox PUB1 -ResidentFolders | ?{$_.Name -ne "IPM_SUBTREE"} | %{$_.Identity}

New-PublicFolderMoveRequest -TargetMailbox PUB2 -Folders $folders

Este exemplo move todas as pastas públicas da caixa de correio de pasta pública Pub1 para a caixa de correio de pasta pública Pub2.

Parâmetros

-AcceptLargeDataLoss

A opção AcceptLargeDataLoss especifica que a solicitação deve continuar mesmo que um grande número de itens na caixa de correio de origem não possa ser copiado para a caixa de correio de destino. Não é preciso especificar um valor com essa opção.

Você precisa usar essa opção se definir o parâmetro LargeItemLimit como um valor de 51 ou mais. Caso contrário, o comando falhará.

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

-AllowLargeItems

A opção AllowLargeItems especifica que você só pode mover itens grandes quando eles são encontrados. Não é preciso especificar um valor com essa opção.

Itens grandes são emails com um máximo de 1.023 anexos.

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

-BadItemLimit

O parâmetro BadItemLimit especifica o número máximo de itens inválidos permitido antes que a solicitação falhe. Um item inválido é um item corrompido na caixa de correio de origem que não pode ser copiado para a caixa de correio de destino. Os itens ausentes também estão incluídos no limite de itens inválidos. Itens ausentes são itens na caixa de correio de origem que não podem ser encontrados na caixa de correio de destino quando a solicitação está pronta para ser concluída.

Uma entrada válida para esse parâmetro é um número inteiro ou o valor ilimitado. O valor padrão é 0, o que significa que a solicitação falhará se algum item ruim for detectado. Se você estiver bem ao deixar alguns itens ruins para trás, poderá definir esse parâmetro como um valor razoável (recomendamos 10 ou menor) para que a solicitação possa continuar. Se muitos itens ruins forem detectados, considere usar o cmdlet New-MailboxRepairRequest para tentar corrigir itens corrompidos na caixa de correio de origem e tente a solicitação novamente.

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

-CompletedRequestAgeLimit

O parâmetro CompletedRequestAgeLimit especifica quanto tempo a solicitação será mantida após a conclusão antes de ser removida automaticamente. O valor padrão desse parâmetro é de 30 dias.

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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.

  • Cmdlets destrutivos (por exemplo, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, cmdlets New-* e Set-*) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Type:SwitchParameter
Aliases:cf
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

-DomainController

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

-Folders

O parâmetro Folders especifica as pastas públicas que você deseja mover. Se a pasta pública tiver pastas públicas filho, essas pastas públicas filho não serão movidas a menos que você as declare explicitamente no comando. Você pode mover várias pastas públicas, separando-os com uma vírgula, por exemplo, \Dev\CustomerEngagements,\Dev\RequestsforChange,\Dev\Usability.

Type:PublicFolderIdParameter[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-InternalFlags

O parâmetro InternalFlags especifica as etapas opcionais na solicitação. Esse parâmetro é usado principalmente para fins de depuração.

Type:InternalMrsFlag[]
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

-Name

O parâmetro Name especifica o nome da solicitação de movimentação da pasta pública. Se você não especificar um nome, o nome padrão é PublicFolderMove.

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

-Priority

O parâmetro Priority especifica a ordem na qual a solicitação deve ser processada na fila de solicitações. As solicitações são processadas em ordem, com base na integridade do servidor, status, prioridade e hora da última atualização. Os valores de prioridade válidos são:

  • Mais Baixo
  • Inferior
  • Baixo
  • Normal: esse é o valor padrão.
  • Alta
  • Superior
  • Mais Alta
  • Emergência
Type:RequestPriority
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

-RequestExpiryInterval

O parâmetro RequestExpiryInterval especifica um limite de idade para uma solicitação concluída ou com falha. Quando você usa esse parâmetro, a solicitação concluída ou que falhou é removida automaticamente depois que o intervalo especificado expira. Se você não usar esse parâmetro:

  • A solicitação concluída será removida automaticamente com base no valor de parâmetro CompletedRequestAgeLimit.
  • Se a solicitação falhar, você precisará removê-la manualmente usando o cmdlet Remove-*Request correspondente.

Para especificar um valor, insira-o como um período de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Quando você usa o valor Unlimited, a solicitação concluída não é removida automaticamente.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-Suspend

A opção Suspend especifica se deve suspender a solicitação. Não é preciso especificar um valor com essa opção.

Caso use essa opção, a solicitação é colocada em fila, mas só vai alcançar o status InProgress quando você retomar a solicitação com o cmdlet de resumo relevante.

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

-SuspendComment

O parâmetro SuspendComment especifica uma descrição do motivo pelo qual a solicitação foi suspensa. Só é possível usar esse parâmetro se o parâmetro Suspend for especificado.

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

-SuspendWhenReadyToComplete

A opção SuspendWhenReadyToComplete especifica se deve suspender a solicitação antes de chegarem ao status de CompletionInProgress. Não é preciso especificar um valor com essa opção.

Depois de suspensa, a movimentação terá um status de AutoSuspended. Você pode concluir manualmente a movimentação usando o comando Resume-PublicFolderMoveRequest.

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

-TargetMailbox

O parâmetro TargetMailbox especifica a caixa de correio de pasta pública de destino para a qual você deseja mover as pastas públicas. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

  • Nome
  • Alias
  • Nome diferenciado (DN)
  • Nome diferenciado (DN)
  • Domain\username
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN
Type:MailboxIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Aliases:wi
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

-WorkloadType

O parâmetro WorkloadType está reservado para uso interno da Microsoft.

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

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.