Update-PublicFolderMailbox
Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen können für die eine oder die andere Umgebung exklusiv sein.
Verwenden Sie das Cmdlet Update-PublicFolderMailbox, um die Hierarchie für öffentliche Ordner zu aktualisieren.
Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.
Syntax
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>]
Beschreibung
Dieses Cmdlet muss nur dann verwendet werden, wenn Sie die Hierarchiesynchronisierung und den Postfachassistenten manuell aufrufen möchten. Beide werden für jedes Postfach für öffentliche Ordner in der Organisation mindestens alle 24 Stunden aufgerufen. Die Hierarchiesynchronisierung wird alle 15 Minuten aufgerufen, wenn Benutzer über Outlook oder einen Exchange-Webdienstclient bei einem sekundären Postfach angemeldet sind.
Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Obwohl in diesem Artikel alle Parameter für das Cmdlet aufgeführt sind, haben Sie möglicherweise keinen Zugriff auf einige Parameter, wenn sie nicht in den Ihnen zugewiesenen Berechtigungen enthalten sind. Wie Sie herausfinden, welche Berechtigungen zur Ausführung eines bestimmten Cmdlets oder Parameters in Ihrer Organisation erforderlich sind, können Sie unter Find the permissions required to run any Exchange cmdlet nachlesen.
Beispiele
Beispiel 1
Update-PublicFolderMailbox -Identity PF_marketing
In diesem Beispiel wird die Hierarchie öffentlicher Ordner im Postfach für öffentliche Ordner PF_marketing aktualisiert.
Beispiel 2
Get-Mailbox -PublicFolder | Update-PublicFolderMailbox
In diesem Beispiel werden alle Postfächer für öffentliche Ordner aktualisiert.
Parameter
-Confirm
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie diese Option sich auf das Cmdlet auswirkt, hängt davon ab, ob für die Option vor dem Fortfahren eine Bestätigung erforderlich ist.
- Destruktive Cmdlets (beispielsweise Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen:
-Confirm:$false. - Die meisten anderen Cmdlets (beispielsweise New-*- und Set-*-Cmdlets) verfügen nicht über eine integrierte Pause. Bei diesen Cmdlets führt das Angeben der Option "Confirm" ohne einen Wert eine Pause ein, die Sie zwingt, den Befehl vor dem Fortfahren zu bestätigen.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | vgl |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-CreateAssociatedDumpster
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Online
Der Schalter CreateAssociatedDumpster gibt an, ob der zugeordnete Dumpster vor der Synchronisierung des Ordners erstellt werden soll. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InvokeSingleFolderSynchronizer
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-DomainController
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Dieser Parameter ist im lokalen Exchange verfügbar.
Der Parameter "DomainController" gibt den Domänencontroller an, der von diesem Cmdlet verwendet wird, um aus Active Directory Daten zu lesen oder hineinzuschreiben. Der Domänencontroller kann anhand seines vollqualifizierten Domänennamens (Fully Qualified Domain Name, FQDN) ermittelt werden. Beispiel: dc01.contoso.com.
Parametereigenschaften
| Typ: | Fqdn |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-FolderId
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Online
Der Parameter FolderId gibt die GUID oder den Namen des öffentlichen Ordners an, der synchronisiert werden soll. Sie können auch den Pfad im Format \TopLevelPublicFolder\PublicFolder einschließen.
Parametereigenschaften
| Typ: | PublicFolderIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InvokeSingleFolderSynchronizer
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ForceOnlineSync
Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Online
Der Schalter ForceOnlineSync gibt an, ob die Synchronisierung des sekundären Postfachs für öffentliche Ordner mit dem primären Postfach für öffentliche Ordner erzwungen werden soll. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InvokeSynchronizer
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-FullSync
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Die FullSync-Option gibt an, dass eine vollständige Synchronisierung des Postfachs für öffentliche Ordner durchgeführt werden soll. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InvokeSynchronizer
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Identity
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Der Parameter Identity gibt das Postfach für öffentliche Ordner an, das Sie aktualisieren möchten. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach eindeutig kennzeichnet. Beispiel:
- Name
- Alias
- Distinguished Name (DN)
- Distinguished Name (DN)
- Domäne\Benutzername
- E-Mail-Adresse
- GUID
- LegacyExchangeDN
- SamAccountName
- Benutzer-ID oder User Principal Name (UPN)
Parametereigenschaften
| Typ: | MailboxIdParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-InvokeSynchronizer
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Die InvokeSynchronizer-Option kann nur für sekundäre Postfächer für öffentliche Ordner der Hierarchie verwendet werden und löst die Hierarchiesynchronisierung vom primären Postfach für öffentliche Ordner zum angegebenen sekundären Postfach für öffentliche Ordner aus. Sie müssen keinen Wert für diese Option angeben.
Diese Option sollte nur zu Problembehandlungszwecken verwendet werden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InvokeSingleFolderSynchronizer
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
InvokeSynchronizer
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ReconcileFolders
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Die ReconcileFolders-Option gibt an, ob genau nach Unterschieden in der Ordnerhierarchie zwischen dem primären Postfach für öffentliche Ordner und dem sekundären Postfach für öffentliche Ordner gesucht werden soll. Ordner, die im primären Postfach für öffentliche Ordner und nicht im sekundären Ordner vorhanden sind, werden neu erstellt. Sie müssen keinen Wert für diese Option angeben.
In lokalem Exchange werden Ordner gelöscht, die im sekundären Postfach für öffentliche Ordner und nicht im primären Postfach vorhanden sind.
In Exchange Online werden Ordner, die im sekundären Postfach für öffentliche Ordner und nicht im primären Ordner vorhanden sind, nach \NON_IPM_SUBTREE\LOST_AND_FOUND verschoben. Weitere Informationen zu LOST_AND_FOUND Funktionalität finden Sie in diesem Blogbeitrag .
In beiden Szenarien können öffentliche Ordner, die gelöscht oder in LOST_AND_FOUND verschoben wurden, mithilfe Set-PublicFolder Befehls wiederhergestellt werden.
In diesem Beispiel wird der öffentliche Ordner "Marketing" aus LOST_AND_FOUND in den Ordner "\South" wiederhergestellt.
Get-PublicFolder \NON_IPM_SUBTREE\LOST_AND_FOUND\5773ba6a-9926-4d64-97db-63a2bdd94a5b\"Pesky Pole" | Set-PublicFolder -Path "\South"
In diesem Beispiel wird der öffentliche Ordner "Documents" aus LOST_AND_FOUND in den Ordner \Engineering wiederhergestellt.
Set-PublicFolder -Identity \NON_IPM_SUBTREE\DUMPSTER_ROOT\DUMPSTER_EXTEND\RESERVED_1\RESERVED_1\9f32c468-4bc2-42aa-b979-16a057394b2f\Documents -Path \Engineering
Hinweis: Sie sollten den Schalter ReconcileFolders nur zu Reparatur- oder Problembehandlungszwecken verwenden, um nach Unterschieden in der Hierarchie öffentlicher Ordner zu suchen, die von einer regulären Synchronisierung nicht erkannt werden. Diese nicht erkannten Unterschiede können in Datenbankfailover- oder Notfallwiederherstellungsszenarien auftreten. Diese Option muss zusammen mit der Option InvokeSynchronizer verwendet werden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InvokeSynchronizer
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-SuppressStatus
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Der SuppressStatus-Schalter gibt an, dass die Ausgabe dieses Cmdlets unterdrückt wird und dass der Befehl asynchron im Hintergrund über die Exchange-Verwaltungsshell ausgeführt wird. Sie müssen keinen Wert für diese Option angeben.
Sie können diesen Schalter nur mit dem InvokeSynchronizer-Schalter verwenden.
Wenn Sie diesen Schalter nicht verwenden, zeigt die Ausgabe bis zu einer Minute lang alle 3 Sekunden status Nachrichten an. Bis die Minute verstreicht, können Sie das PowerShell-Fenster nicht für andere Befehle verwenden.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
InvokeSynchronizer
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-WhatIf
Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
Die Option "WhatIf" simuliert die Aktionen des Befehls. Sie können diesen Switch verwenden, um die Änderungen anzuzeigen, die auftreten würden, ohne diese Änderungen tatsächlich anzuwenden. Sie müssen keinen Wert für diese Option angeben.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Wi |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen finden Sie unter about_CommonParameters.
Eingaben
Input types
Eingabetypen, die dieses Cmdlet akzeptiert, finden Sie unter Eingabe- und Ausgabetypen für Cmdlets. Wenn das Feld mit dem Eingabetyp für ein Cmdlet leer ist, akzeptiert das Cmdlet diese Eingabedaten nicht.
Ausgaben
Output types
Informationen zu den Rückgabetypen, die auch als Ausgabetypen bezeichnet werden und die von diesem Cmdlet akzeptiert werden, finden Sie unter Eingabe- und Ausgabetypen von Cmdlets. Wenn das Feld mit dem Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.