Freigeben über


New-PublicFolderMoveRequest

Dieses Cmdlet ist nur lokal in Exchange verfügbar.

Verwenden Sie das Cmdlet New-PublicFolderMoveRequest, um mit dem Verschieben von Inhalten öffentlicher Ordner zwischen Postfächern für öffentliche Ordner zu beginnen. Beim Verschieben öffentlicher Ordner wird nur der physische Inhalt des öffentlichen Ordners verschoben, ohne dass sich die logische Hierarchie ändert. Wenn die Verschiebungsanforderung abgeschlossen ist, müssen Sie das Cmdlet Remove-PublicFolderMoveRequest ausführen, um die Anforderung zu entfernen, oder warten, bis die im CompletedRequestAgeLimit-Parameter angegebene Zeit abgelaufen ist. Die Anforderung muss entfernt werden, bevor Sie eine weitere Verschiebungsanforderung ausführen können.

Beachten Sie, dass das Zielpostfach für öffentliche Ordner gesperrt wird, während die Verschiebungsanforderung aktiv ist. Weitere Informationen finden Sie im Abschnitt Beschreibung.

Informationen zu den Parametersätzen im Abschnitt zur Syntax weiter unten finden Sie unter Syntax der Exchange-Cmdlets.

Syntax

New-PublicFolderMoveRequest
   -Folders <PublicFolderIdParameter[]>
   -TargetMailbox <MailboxIdParameter>
   [-AcceptLargeDataLoss]
   [-AllowLargeItems]
   [-BadItemLimit <Unlimited>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-Name <String>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-Suspend]
   [-SuspendComment <String>]
   [-SuspendWhenReadyToComplete]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-PublicFolderMoveRequest verschiebt öffentliche Ordner aus einem Quellpostfach für öffentliche Ordner in ein Zielpostfach für öffentliche Ordner. Während die Verschiebungsanforderung aktiv ist, wird das Zielpostfach für öffentliche Ordner gesperrt. Daher kann auf öffentliche Ordner, die sich bereits im Zielpostfach für öffentliche Ordner befinden, nicht zugegriffen werden, bis die Verschiebungsanforderung abgeschlossen ist. Bevor Sie mit der Verschiebungsanforderung beginnen, sollten Sie daher sicherstellen, dass keine Benutzer auf Öffentliche Ordnerdaten in diesem Zielpostfach für öffentliche Ordner zugreifen.

Verwenden Sie das Cmdlet New-MoveRequest, um das Postfach für öffentliche Ordner in eine andere Postfachdatenbank zu verschieben. Um sicherzustellen, dass sich dieser Ordner bereits im Zielpostfach für öffentliche Ordner befindet, führen Sie das Cmdlet Update-PublicFolderMailbox für das Zielpostfach für öffentliche Ordner aus. Sie können jeweils nur eine Verschiebungsanforderung ausführen. Sie können öffentliche Ordner auch mithilfe des skripts Move-PublicFolderBranch.ps1 verschieben.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Auch wenn in diesem Thema alle Parameter für das Cmdlet aufgeführt werden, verfügen Sie möglicherweise nicht über den 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

New-PublicFolderMoveRequest -Folders \DeveloperReports\CustomerEngagements -TargetMailbox DeveloperReports01

In diesem Beispiel wird die Verschiebungsanforderung für den öffentlichen Ordner \CustomerEngagements vom Postfach für öffentliche Ordner DeveloperReports zu DeveloperReports01 gestartet.

Beispiel 2

New-PublicFolderMoveRequest -Folders \Dev\CustomerEngagements,\Dev\RequestsforChange,\Dev\Usability -TargetMailbox DeveloperReports01

Dieses Beispiel startet die Verschiebungsanforderung für öffentlichen Ordner unter der Verzweigung "\Dev public" in das Zielpostfach "DeveloperReports01".

Sie können auch eine Verzweigung öffentlicher Ordner mithilfe des skripts Move-PublicFolderBranch.ps1 verschieben.

Beispiel 3

$folders = Get-PublicFolder \ -Recurse -Mailbox PUB1 -ResidentFolders | ?{$_.Name -ne "IPM_SUBTREE"} | %{$_.Identity}

New-PublicFolderMoveRequest -TargetMailbox PUB2 -Folders $folders

In diesem Beispiel werden alle öffentlichen Ordner aus dem Öffentlichen Ordner-Postfach Pub1 in das Postfach Pub2 für öffentliche Ordner verschoben.

Parameter

-AcceptLargeDataLoss

Die AcceptLargeDataLoss-Option gibt an, dass die Anforderung auch dann fortgesetzt werden soll, wenn eine große Anzahl von Elementen im Quellpostfach nicht in das Zielpostfach kopiert werden kann. Sie müssen bei dieser Option keinen Wert angeben.

Sie müssen diesen Schalter verwenden, wenn Sie den LargeItemLimit-Parameter auf einen Wert von 51 oder höher festlegen. Andernfalls führt der Befehl zu einem Fehler.

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

-AllowLargeItems

Der Schalter AllowLargeItems gibt an, dass Sie große Elemente nur verschieben können, wenn sie gefunden werden. Sie müssen bei dieser Option keinen Wert angeben.

Große Elemente sind E-Mail-Nachrichten mit maximal 1.023 Anlagen.

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

-BadItemLimit

Der Parameter "BadItemLimit" gibt die maximale Anzahl von ungültigen Elementen an, die zulässig sind, bevor die Anforderung einen Fehler verursacht. Ein "ungültiges Element" ist ein fehlerhaftes Element im Quellpostfach, das nicht in das Zielpostfach kopiert werden kann. Der Grenzwert für ungültige Elemente enthält auch fehlende Elemente. Fehlende Elemente sind Elemente im Quellpostfach, die im Zielpostfach nicht gefunden werden können, wenn die Anforderung abgeschlossen werden kann.

Eine gültige Eingabe für diesen Parameter ist eine Ganzzahl oder der Wert "Unlimited". Der Standardwert ist 0. Dies bedeutet, dass die Anforderung fehlschlägt, wenn fehlerhafte Elemente erkannt werden. Wenn Sie in Ordnung sind, einige fehlerhafte Elemente zurückzulassen, können Sie diesen Parameter auf einen vernünftigen Wert festlegen (wir empfehlen 10 oder niedriger), damit die Anforderung fortgesetzt werden kann. Wenn zu viele ungültige Elemente erkannt werden, sollten Sie das Cmdlet New-MailboxRepairRequest verwenden, um zu versuchen, beschädigte Elemente im Quellpostfach zu beheben, und versuchen Sie es dann erneut.

Type:Unlimited
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

-CompletedRequestAgeLimit

Der Parameter CompletedRequestAgeLimit gibt an, wie lange die Anforderung beibehalten wird, nachdem sie abgeschlossen wurde, bevor sie automatisch entfernt wird. Der Standardwert für diesen Parameter beträgt 30 Tage.

Type:Unlimited
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

-Confirm

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 (z. B. Remove-*-Cmdlets) verfügen über eine integrierte Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren. Für diese Cmdlets können Sie die Bestätigungsaufforderung mit genau dieser Syntax überspringen: -Confirm:$false.
  • Die meisten anderen Cmdlets (z. B. 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.
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

-DomainController

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.

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

-Folders

Der Folders-Parameter gibt die öffentlichen Ordner an, die Sie verschieben möchten. Wenn der öffentliche Ordner über untergeordnete öffentliche Ordner verfügt, werden diese untergeordneten öffentlichen Ordner nur verschoben, wenn Sie sie explizit im Befehl angeben. Sie können mehrere öffentliche Ordner verschieben, indem Sie sie durch ein Komma trennen, z. B. \Dev\CustomerEngagements,\Dev\RequestsforChange,\Dev\Usability.

Type:PublicFolderIdParameter[]
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

-InternalFlags

Der Parameter "InternalFlags" gibt die optionalen Schritte in der Anforderung an. Dieser Parameter wird in erster Linie zu Debuggingzwecken verwendet.

Type:InternalMrsFlag[]
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

-Name

Der Parameter Name gibt den Namen der Verschiebungsanforderung für öffentliche Ordner an. Wenn Sie keinen Namen angeben, lautet der Standardname PublicFolderMove.

Type:String
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

-Priority

Der Parameter "Priority" gibt die Priorität an, mit der die Anforderung in der Anforderungswarteschlange verarbeitet werden soll. Anforderungen werden basierend auf Serverintegrität, Status, Priorität und letzter Aktualisierung in einer bestimmten Reihenfolge verarbeitet. Gültige Prioritätswerte sind:

  • Lowest
  • Lower
  • Low
  • Normal (Standardwert)
  • High
  • Higher
  • Highest
  • Emergency
Type:RequestPriority
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

-RequestExpiryInterval

Der Parameter "RequestExpiryInterval" gibt eine Verfallszeit für eine abgeschlossene oder fehlerhafte Anforderung an. Beim Verwenden dieses Parameters wird die abgeschlossene oder fehlerhafte Anforderung automatisch entfernt, nachdem der angegebene Zeitraum abgelaufen ist. Bei Nichtverwendung dieses Parameters:

  • Die abgeschlossene Anforderung wird auf Grundlage des CompletedRequestAgeLimit-Parameterwerts automatisch entfernt.
  • Wenn die Anforderung fehlschlägt, müssen Sie sie mithilfe des entsprechenden Remove-*Request-Cmdlets manuell entfernen.

Geben Sie zum Angeben eines Werts diesen als einen Zeitraum an: dd.hh:mm:ss, wobei dd Tagen, hh Stunden, mm Minuten und ss Sekunden entspricht.

Beim Verwenden des Werts "Unlimited" wird die abgeschlossene Anforderung nicht automatisch entfernt.

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

-Suspend

Die Option "Suspend" gibt an, ob die Anforderung angehalten werden soll. Sie müssen keinen Wert für diese Option angeben.

Wenn Sie diese Option verwenden, wird die Anforderung in die Warteschlange eingereiht, erreicht jedoch erst den Status InProgress, wenn Sie die Anforderung mit dem entsprechenden Cmdlet fortsetzen.

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

-SuspendComment

Der Parameter "SuspendComment" gibt eine Beschreibung an, warum die Anforderung angehalten wurde. Dieser Parameter kann nur zusammen mit dem Parameter "Suspend" verwendet werden.

Type:String
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

-SuspendWhenReadyToComplete

Der Schalter SuspendWhenReadyToComplete gibt an, ob die Anforderung angehalten werden soll, bevor sie die status von CompletionInProgress erreicht. Sie müssen bei dieser Option keinen Wert angeben.

Nach dem Anhalten der Verschiebung lautet der Status AutoSuspended. Sie können die Verschiebung anschließend mit dem Befehl Resume-PublicFolderMoveRequest manuell abschließen.

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

-TargetMailbox

Der Parameter TargetMailbox gibt das Zielpostfach für öffentliche Ordner an, in das Sie die öffentlichen Ordner verschieben 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)
Type:MailboxIdParameter
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

-WhatIf

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.

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

-WorkloadType

Der WorkloadType-Parameter ist für die interne Verwendung von Microsoft reserviert.

Type:RequestWorkloadType
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

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, die dieses Cmdlet akzeptiert, finden Sie unter Cmdlet Input and Output Types. Wenn das Feld Ausgabetyp leer ist, gibt das Cmdlet keine Daten zurück.