Update-PublicFolderMailbox

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 Update-PublicFolderMailbox para atualizar a hierarquia de pastas públicas.

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

Syntax

Update-PublicFolderMailbox
      [-Identity] <MailboxIdParameter>
      [-ForceOnlineSync]
      [-FullSync]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-InvokeSynchronizer]
      [-ReconcileFolders]
      [-SuppressStatus]
      [-WhatIf]
      [<CommonParameters>]
Update-PublicFolderMailbox
      [-Identity] <MailboxIdParameter>
      -FolderId <PublicFolderIdParameter>
      -InvokeSynchronizer
      [-CreateAssociatedDumpster]
      [-Confirm]
      [-DomainController <Fqdn>]
      [-WhatIf]
      [<CommonParameters>]

Description

Este cmdlet deve ser usado apenas se você quiser invocar manualmente o sincronizador de hierarquia e o assistente de caixa de correio. Ambos são invocados pelo menos uma vez a cada 24 horas, para cada caixa de correio de pasta pública na organização. O sincronizador de hierarquia é invocado a cada 15 minutos se algum usuário estiver conectado a uma caixa de correio secundária por meio do Outlook ou de um cliente do Exchange Web Services.

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

Update-PublicFolderMailbox -Identity PF_marketing

Este exemplo atualiza a hierarquia de pasta pública na caixa de correio da pasta pública PF_marketing.

Exemplo 2

Get-Mailbox -PublicFolder | Update-PublicFolderMailbox

Este exemplo atualiza todas as caixas de correio de pasta pública.

Parâmetros

-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, Exchange Online

-CreateAssociatedDumpster

O comutador CreateAssociatedDumpster especifica se deve criar a lixeira associada antes de sincronizar a pasta. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-FolderId

O parâmetro FolderId especifica o GUID ou o nome da pasta pública que você deseja sincronizar. Também é possível incluir o caminho usando o formato \Pasta_pública_de_nível_superior\Pasta_pública.

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

-ForceOnlineSync

A opção ForceOnlineSync especifica se a caixa de correio de pasta pública secundária deve ser sincronizada com a caixa de correio de pasta pública primária. Não é preciso especificar um valor com essa opção.

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

-FullSync

A opção FullSync especifica que você deseja executar uma sincronização completa da caixa de correio de pasta pública. Não é preciso especificar um valor com essa opção.

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, Exchange Online

-Identity

O parâmetro Identidade especifica a caixa de correio de pasta pública que você deseja atualizar. É 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:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-InvokeSynchronizer

A opção InvokeSynchronizer pode ser usada somente em caixas de correio de pasta pública de hierarquia secundária e aciona a sincronização de hierarquia a partir da caixa de correio de pasta pública primária para a caixa de correio de pasta pública secundária especificada. Não é preciso especificar um valor com essa opção.

Essa opção deve ser usada somente para solução de problemas.

Type:SwitchParameter
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, Exchange Online

-ReconcileFolders

A opção ReconcileFolders especifica se diferenças na hierarquia de pastas entre a caixa de correio de pasta pública primária e a caixa de correio de pasta pública secundária devem ser analisadas atentamente. Pastas presentes na caixa de correio de pasta pública primária e ausentes na secundária serão recriadas. Não é preciso especificar um valor com essa opção.

No Exchange local, as pastas que existem na caixa de correio de pasta pública secundária e não no primário serão excluídas.

Em Exchange Online, as pastas que existem na caixa de correio de pasta pública secundária e não no primário serão movidas para \NON_IPM_SUBTREE\LOST_AND_FOUND. Confira esta postagem no blog para obter mais detalhes sobre LOST_AND_FOUND funcionalidade.

Em ambos os cenários, pastas públicas que foram excluídas ou movidas para LOST_AND_FOUND podem ser restauradas usando Set-PublicFolder comando.

Este exemplo restaura a pasta pública chamada "Marketing" de LOST_AND_FOUND para a pasta chamada \South

Get-PublicFolder \NON_IPM_SUBTREE\LOST_AND_FOUND\5773ba6a-9926-4d64-97db-63a2bdd94a5b\"Pesky Pole" | Set-PublicFolder -Path "\South"

Este exemplo restaura a pasta pública chamada "Documentos" de LOST_AND_FOUND para a pasta chamada \Engenharia

Set-PublicFolder -Identity \NON_IPM_SUBTREE\DUMPSTER_ROOT\DUMPSTER_EXTEND\RESERVED_1\RESERVED_1\9f32c468-4bc2-42aa-b979-16a057394b2f\Documents -Path \Engineering

Observação: você deve usar a opção ReconciliarPaixas somente para fins de reparo ou solução de problemas para procurar diferenças na hierarquia de pastas públicas que não são detectadas por uma sincronização regular. As diferenças não detectadas podem ocorrer em cenários de recuperação de desastres ou de failover de banco de dados. Essa opção deve ser usada com a opção InvokeSynchronizer.

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, Exchange Online

-SuppressStatus

A opção SuppressStatus especifica que a saída desse cmdlet será suprimida e que o comando será executado de forma assíncrona em segundo plano a partir do Shell de Gerenciamento do Exchange. Não é preciso especificar um valor com essa opção.

Você só pode usar essa opção com a opção InvokeSynchronizer.

Se você não usar essa opção, a saída exibirá mensagens de status a cada 3 segundos por até um minuto. Até que o minuto passe, você não poderá usar a Janela do PowerShell para outros comandos.

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, Exchange Online

-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, Exchange Online

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.