Condividi tramite


Update-PublicFolderMailbox

Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni potrebbero essere esclusivi per un ambiente o l'altro.

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

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

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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-CreateAssociatedDumpster

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

InvokeSingleFolderSynchronizer
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DomainController

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.

Proprietà dei parametri

Tipo:Fqdn
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FolderId

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Proprietà dei parametri

Tipo:PublicFolderIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

InvokeSingleFolderSynchronizer
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ForceOnlineSync

Applicabile: Exchange Server 2016, Exchange Server 2019, Exchange Online

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

InvokeSynchronizer
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-FullSync

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

InvokeSynchronizer
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

Proprietà dei parametri

Tipo:MailboxIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-InvokeSynchronizer

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

InvokeSingleFolderSynchronizer
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False
InvokeSynchronizer
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ReconcileFolders

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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 della cartella pubblica primaria e non nella cartella secondaria vengono 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 vengono eliminate.

In Exchange Online, le cartelle presenti nella cassetta postale delle cartelle pubbliche secondarie e non nella cartella primaria vengono 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 negli scenari di failover o ripristino di emergenza del database. È necessario utilizzare tale opzione con l'opzione InvokeSynchronizer.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

InvokeSynchronizer
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SuppressStatus

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

L'opzione SuppressStatus specifica che l'output di questo cmdlet viene eliminato e che il comando viene eseguito in modo asincrono in background 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 visualizza 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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

InvokeSynchronizer
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

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.