Update-PublicFolderMailbox

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.

Utilizzare il cmdlet Update-PublicFolderMailbox per aggiornare la gerarchia delle cartelle pubbliche.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

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

Descrizione

È necessario usare questo cmdlet solo quando si desidera avviare manualmente la sincronizzazione della gerarchia e l'assistente delle cassette postali. Entrambi vengono avviati almeno una volta ogni 24 ore per ciascuna cassetta postale delle cartelle pubbliche nell'organizzazione. Il programma di sincronizzazione della gerarchia viene richiamato ogni 15 minuti se gli utenti sono connessi a una cassetta postale secondaria tramite Outlook o un client di Servizi Web Exchange.

È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.

Esempio

Esempio 1

Update-PublicFolderMailbox -Identity PF_marketing

In questo esempio viene aggiornata la gerarchia di cartelle pubbliche nella cassetta postale delle cartelle pubbliche PF_marketing.

Esempio 2

Get-Mailbox -PublicFolder | Update-PublicFolderMailbox

In questo esempio vengono aggiornate tutte le cassette postali delle cartelle pubbliche.

Parametri

-Confirm

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.

  • I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi: -Confirm:$false.
  • La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
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

L'opzione CreateAssociatedDumpster specifica se creare il dumpster associato prima di sincronizzare la cartella. Con questa opzione non è necessario specificare alcun valore.

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

Questo parametro è disponibile solo in Exchange locale.

Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, 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

Il parametro FolderId specifica il GUID o il nome della cartella pubblica da sincronizzare. È, inoltre, possibile includere il percorso utilizzando il formato \CartellaPubblicaLivelloSuperiore\CartellaPubblica.

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

L'opzione ForceOnlineSync specifica se forzare la sincronizzazione della cassetta postale della cartella pubblica secondaria con la cassetta postale della cartella pubblica primaria. Con questa opzione non è necessario specificare alcun valore.

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

L'opzione FullSync specifica che si desidera eseguire una sincronizzazione completa delle cassette postali delle cartelle pubbliche. Con questa opzione non è necessario specificare alcun valore.

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

Il parametro Identity consente di specificare la cassetta postale della cartella pubblica da aggiornare. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Dominio\nomeutente
  • Indirizzo di posta elettronica
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ID utente o Nome entità utente (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

L'opzione InvokeSynchronizer può essere utilizzata solo per gerarchie di cassette postali delle cartelle pubbliche secondarie e avvia la sincronizzazione della gerarchia dalla cassetta postale delle cartelle pubbliche primaria alla cassetta postale delle cartelle pubbliche secondaria specificata. Con questa opzione non è necessario specificare alcun valore.

L'opzione deve essere utilizzata solo per la risoluzione dei problemi.

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

L'opzione ReconcileFolders consente di specificare se cercare strettamente differenze nella gerarchia delle cartelle tra la cassetta postale di cartelle pubbliche primaria e la cassetta postale di cartelle pubbliche secondaria. Le cartelle presenti nella cassetta postale di cartelle pubbliche principale e non in quella secondaria verranno ricreate. Con questa opzione non è necessario specificare alcun valore.

In Exchange locale, le cartelle presenti nella cassetta postale delle cartelle pubbliche secondarie e non nella cartella primaria verranno eliminate.

In Exchange Online, le cartelle presenti nella cassetta postale delle cartelle pubbliche secondarie e non nella cartella primaria verranno spostate in \NON_IPM_SUBTREE\LOST_AND_FOUND. Per altre informazioni sulle funzionalità LOST_AND_FOUND, vedere questo post di blog .

In entrambi gli scenari, le cartelle pubbliche eliminate o spostate in LOST_AND_FOUND possono essere ripristinate usando Set-PublicFolder comando.

In questo esempio viene ripristinata la cartella pubblica denominata "Marketing" da LOST_AND_FOUND alla cartella denominata \South

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

In questo esempio viene ripristinata la cartella pubblica denominata "Documents" da LOST_AND_FOUND alla cartella denominata \Engineering

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

Nota: è consigliabile usare l'opzione ReconcileFolders solo a scopo di ripristino o risoluzione dei problemi per individuare le differenze nella gerarchia di cartelle pubbliche che non vengono rilevate da una sincronizzazione regolare. Queste differenze non rilevate possono verificarsi in scenari di ripristino di failover o di un guasto di database. È necessario utilizzare tale opzione con l'opzione 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

L'opzione SuppressStatus consente di specificare che l'output di questo cmdlet è stato eliminato e che il comando verrà eseguito in modo asincrono in backgruond da Exchange Management Shell. Con questa opzione non è necessario specificare alcun valore.

È possibile usare questa opzione solo con l'opzione InvokeSynchronizer.

Se non si usa questa opzione, l'output visualizzerà i messaggi di stato ogni 3 secondi per un massimo di un minuto. Fino a quando non passa il minuto, non è possibile usare la finestra di PowerShell per altri comandi.

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

L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.

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

Input

Input types

Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.

Output

Output types

Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.