Partilhar via

New-PublicFolderMoveRequest

Módulo:
Exchange PowerShell

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.

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.

Tenha em atenção que os wis da caixa de correio da pasta pública de destino estão bloqueados enquanto o pedido de movimentação está ativo. Para obter mais informações, consulte a secção Descrição.

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

Sintaxe

Default (Padrão) 

New-PublicFolderMoveRequest
    -Folders <PublicFolderIdParameter[]>
    -TargetMailbox <MailboxIdParameter>
    [-AcceptLargeDataLoss]
    [-AllowLargeItems]
    [-BadItemLimit <Unlimited>]
    [-CompletedRequestAgeLimit <Unlimited>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-InternalFlags <InternalMrsFlag[]>]
    [-Name <String>]
    [[-Organization] <OrganizationIdParameter>]
    [-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 o pedido de movimentação estiver ativo, a caixa de correio da pasta pública de destino está bloqueada. Como resultado, as pastas públicas que já residem na caixa de correio da pasta pública de destino estão inacessíveis até que o pedido de movimentação esteja concluído. Por conseguinte, antes de iniciar o pedido de movimentação, deve certificar-se de que nenhum utilizador está a aceder aos dados de pastas públicas 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 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

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

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

O comutador AcceptLargeDataLoss especifica que o pedido 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.

Propriedades do parâmetro

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

-AllowLargeItems

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

O comutador AllowLargeItems especifica que só pode mover itens grandes quando forem encontrados. Não é preciso especificar um valor com essa opção.

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

Propriedades do parâmetro

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

-BadItemLimit

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

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. Os itens em falta são itens na caixa de correio de origem que não podem ser encontrados na caixa de correio de destino quando o pedido está pronto para ser concluído.

Uma entrada válida para esse parâmetro é um número inteiro ou o valor ilimitado. O valor predefinido é 0, o que significa que o pedido falhará se forem detetados itens incorretos. Se não se importa de deixar alguns itens incorretos para trás, pode definir este parâmetro para um valor razoável (recomendamos 10 ou inferior) para que o pedido possa prosseguir. Se forem detetados demasiados itens incorretos, considere utilizar o cmdlet New-MailboxRepairRequest para tentar corrigir itens danificados na caixa de correio de origem e, em seguida, tente o pedido novamente.

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

-CompletedRequestAgeLimit

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

O parâmetro CompletedRequestAgeLimit especifica quanto tempo o pedido é mantido após a conclusão antes de ser removido automaticamente. O valor predefinido para este parâmetro é 30 dias.

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

-Confirm

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

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, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
  • A maioria dos outros cmdlets (por exemplo, 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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

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

-DomainController

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

Este parâmetro só é funcional 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

-Folders

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

O parâmetro Folders especifica as pastas públicas que você deseja mover. Se a pasta pública tiver pastas públicas subordinadas, estas pastas públicas subordinadas não são movidas, a menos que as indique 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.

Propriedades do parâmetro

Tipo:

PublicFolderIdParameter[]

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

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InternalFlags

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

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

Propriedades do parâmetro

Tipo:

InternalMrsFlag[]

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

-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 movimentação da pasta pública. Se você não especificar um nome, o nome padrão é PublicFolderMove.

Propriedades do parâmetro

Tipo:String
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

-Organization

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

{{ Descrição da Organização de Preenchimento }}

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:7
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Priority

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

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: este valor é a predefinição.
  • Alta
  • Superior
  • Mais Alta
  • Emergência

Propriedades do parâmetro

Tipo:RequestPriority
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

-RequestExpiryInterval

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

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 o pedido falhar, terá de removê-lo manualmente com 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.

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

-Suspend

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

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

Se utilizar este comutador, o pedido é colocado em fila de espera, mas o pedido não chega ao status de Entrada até retomar o pedido com o cmdlet de currículo relevante.

Propriedades do parâmetro

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

-SuspendComment

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

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.

Propriedades do parâmetro

Tipo:String
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

-SuspendWhenReadyToComplete

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

Este parâmetro está disponível somente no Exchange local.

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.

Propriedades do parâmetro

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

-TargetMailbox

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

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)
  • Domínio\Nome de Utilizador
  • Endereço de email
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID de usuário ou nome UPN

Propriedades do parâmetro

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

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

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

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.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

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

-WorkloadType

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

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

Propriedades do parâmetro

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

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.