Freigeben über

New-PublicFolderMoveRequest

Modul:
Exchange PowerShell

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 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 ist, 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

Default (Standardwert) 

New-PublicFolderMoveRequest
    -Folders <PublicFolderIdParameter[]>
    -TargetMailbox <MailboxIdParameter>
    [-AcceptLargeDataLoss]
    [-AllowLargeItems]
    [-BadItemLimit <Unlimited>]
    [-CompletedRequestAgeLimit <Unlimited>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-InternalFlags <InternalMrsFlag[]>]
    [-Name <String>]
    [[-Organization] <OrganizationIdParameter>]
    [-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, ist 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. 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

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

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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 keinen Wert für diese Option angeben.

Parametereigenschaften

Typ:SwitchParameter
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

-AllowLargeItems

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

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

Parametereigenschaften

Typ:SwitchParameter
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

-BadItemLimit

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

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.

Parametereigenschaften

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

-CompletedRequestAgeLimit

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Parametereigenschaften

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

-Confirm

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, 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

-DomainController

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

Dieser Parameter ist nur in lokalem Exchange funktionsfähig.

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

-Folders

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Parametereigenschaften

Typ:

PublicFolderIdParameter[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-InternalFlags

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Parametereigenschaften

Typ:

InternalMrsFlag[]

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

-Name

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Parametereigenschaften

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

-Organization

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

{{ Organisationsbeschreibung ausfüllen }}

Parametereigenschaften

Typ:OrganizationIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:7
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Priority

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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: Dieser Wert ist die Standardeinstellung.
  • High
  • Higher
  • Highest
  • Emergency

Parametereigenschaften

Typ:RequestPriority
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

-RequestExpiryInterval

Anwendbar: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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.

Parametereigenschaften

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

-Suspend

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Wenn Sie diesen Switch verwenden, wird die Anforderung in die Warteschlange eingereiht, aber die Anforderung erreicht den status von InProgress erst, wenn Sie die Anforderung mit dem entsprechenden Resume-Cmdlet fortsetzen.

Parametereigenschaften

Typ:SwitchParameter
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

-SuspendComment

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Parametereigenschaften

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

-SuspendWhenReadyToComplete

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Schalter SuspendWhenReadyToComplete gibt an, ob die Anforderung angehalten werden soll, bevor sie die status von CompletionInProgress erreicht. Sie müssen keinen Wert für diese Option 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.

Parametereigenschaften

Typ:SwitchParameter
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

-TargetMailbox

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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)

Parametereigenschaften

Typ:MailboxIdParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:True
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 Server SE, 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

-WorkloadType

Anwendbar: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

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

Parametereigenschaften

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

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.