Update-PublicFolderMailbox
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 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.
Sintaxe
InvokeSynchronizer
Update-PublicFolderMailbox
[-Identity] <MailboxIdParameter>
[-ForceOnlineSync]
[-FullSync]
[-Confirm]
[-DomainController <Fqdn>]
[-InvokeSynchronizer]
[-ReconcileFolders]
[-SuppressStatus]
[-WhatIf]
[<CommonParameters>]
InvokeSingleFolderSynchronizer
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 synchronizer de hierarquia é invocado a cada 15 minutos se algum utilizador tiver sessão iniciada numa caixa de correio secundária através do Outlook ou de um cliente dos Serviços Web Exchange.
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
Update-PublicFolderMailbox -Identity PF_marketing
Este exemplo atualiza a hierarquia de pastas públicas na caixa de correio de pasta pública PF_marketing.
Exemplo 2
Get-Mailbox -PublicFolder | Update-PublicFolderMailbox
Este exemplo atualiza todas as caixas de correio de pastas públicas.
Parâmetros
-Confirm
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 |
-CreateAssociatedDumpster
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Online
O comutador CreateAssociatedDumpster especifica se pretende criar o contentor de informação associado antes de sincronizar a pasta. 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
InvokeSingleFolderSynchronizer
| 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
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 |
-FolderId
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Online
O parâmetro FolderId especifica o GUID ou o nome da pasta pública que pretende sincronizar. Também é possível incluir o caminho usando o formato \Pasta_pública_de_nível_superior\Pasta_pública.
Propriedades do parâmetro
| Tipo: | PublicFolderIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
InvokeSingleFolderSynchronizer
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ForceOnlineSync
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Online
O comutador ForceOnlineSync especifica se pretende forçar a caixa de correio da pasta pública secundária a sincronizar com a caixa de correio da pasta pública principal. 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
InvokeSynchronizer
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-FullSync
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
InvokeSynchronizer
| 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 Online
O parâmetro Identidade especifica a caixa de correio da pasta pública que pretende atualizar. É 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: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-InvokeSynchronizer
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
InvokeSingleFolderSynchronizer
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
InvokeSynchronizer
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ReconcileFolders
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
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. As pastas que existem na caixa de correio da pasta pública principal e não na secundária são recriadas. Não é preciso especificar um valor com essa opção.
No Exchange no local, as pastas que existem na caixa de correio da pasta pública secundária e não na principal são eliminadas.
No Exchange Online, as pastas que existem na caixa de correio da pasta pública secundária e não na primária são movidas para \NON_IPM_SUBTREE\LOST_AND_FOUND. Veja esta mensagem de blogue para obter mais detalhes sobre LOST_AND_FOUND funcionalidade.
Em ambos os cenários, as pastas públicas que foram eliminadas ou movidas para LOST_AND_FOUND podem ser restauradas com Set-PublicFolder comando.
Este exemplo restaura a pasta pública denominada "Marketing" de LOST_AND_FOUND para a pasta com o nome \Sul
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 denominada "Documentos" de LOST_AND_FOUND para a pasta com o nome \Engineering
Set-PublicFolder -Identity \NON_IPM_SUBTREE\DUMPSTER_ROOT\DUMPSTER_EXTEND\RESERVED_1\RESERVED_1\9f32c468-4bc2-42aa-b979-16a057394b2f\Documents -Path \Engineering
Nota: deve utilizar o comutador ReconcileFolders apenas para reparação ou resolução de problemas para procurar diferenças na hierarquia de pastas públicas que não são detetadas por uma sincronização regular. Estas diferenças não detetadas podem ocorrer em cenários de ativação pós-falha ou recuperação após desastre da base de dados. Essa opção deve ser usada com a opção InvokeSynchronizer.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
InvokeSynchronizer
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-SuppressStatus
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
O comutador SuppressStatus especifica que a saída deste cmdlet é suprimida e que o comando é executado de forma assíncrona em segundo plano a partir da Shell de Gestão do Exchange. Não é preciso especificar um valor com essa opção.
Só pode utilizar este comutador com o comutador InvokeSynchronizer.
Se não utilizar este comutador, o resultado apresenta status mensagens a cada 3 segundos até um minuto. Até que o minuto passe, não pode utilizar a Janela do PowerShell para outros comandos.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
InvokeSynchronizer
| Cargo: | Named |
| Obrigatório: | False |
| 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 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 |
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.