New-PublicFolderMoveRequest

Modul:: Exchange PowerShell

Dieses Cmdlet ist der lokalen Bereitstellung von Exchange und im cloudbasierten Dienst verfügbar. Einige Parameter und Einstellungen sind möglicherweise exklusiv für die eine oder andere Umgebung.

Verwenden Sie das Cmdlet New-PublicFolderMoveRequest, um mit dem Verschieben von Inhalten Öffentlicher Ordner zwischen Postfächern Öffentlicher 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 Remove-PublicFolderMoveRequest Cmdlet ausführen, um die Anforderung zu entfernen, oder warten, bis die im Parameter CompletedRequestAgeLimit angegebene Zeit abgelaufen ist. Die Anforderung muss entfernt werden, bevor Sie einen weiteren Verschiebungsantrag ausführen können.

Beachten Sie, dass das öffentliche Zielpostfach des öffentlichen Ordners 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 (Standard)

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

Mit dem Cmdlet New-PublicFolderMoveRequest werden öffentliche Ordner von einem Quellpostfach für öffentliche Ordner in ein Zielpostfach für öffentliche Ordner verschoben. Während die Verschiebungsanforderung aktiv ist, ist das Zielpostfach des öffentlichen Ordners gesperrt. Auf öffentliche Ordner, die sich bereits im Zielpostfach des öffentlichen Ordners befinden, kann daher erst dann zugegriffen werden, wenn die Verschiebungsanforderung abgeschlossen ist. Bevor Sie mit der Verschiebungsanforderung beginnen, sollten Sie daher sicherstellen, dass keine Benutzer auf Öffentliche Ordner-Daten in dem Öffentliche Ordner-Zielpostfach 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 des öffentlichen Ordners befindet, führen Sie das Cmdlet Update-PublicFolderMailbox für das öffentliche Ordner-Zielpostfach 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 beginnt die Verschiebungsanforderung für den öffentlichen Ordner \CustomerEngagements aus dem öffentlichen Ordner-Postfach DeveloperReports nach DeveloperReports01.

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 einen Zweig von öffentlichen Ordnern auch 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 vom Öffentliche Ordner-Postfach Pub1 in das Öffentliche Ordner-Postfach Pub2 verschoben.

Parameter

-AcceptLargeDataLoss

Der Schalter AcceptLargeDataLoss 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

Der Schalter AllowLargeItems gibt an, dass Sie große Elemente nur verschieben können, wenn sie vorhanden sind. 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

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 zum Abschluss bereit ist.

Eine gültige Eingabe für diesen Parameter ist eine Ganzzahl oder der Wert "Unlimited". Der Standardwert ist 0, d. h., die Anforderung schlägt fehl, wenn ungültige Elemente erkannt werden. Wenn es für Sie in Ordnung ist, ein paar schlechte Elemente zurückzulassen, können Sie diesen Parameter auf einen sinnvollen Wert festlegen (wir empfehlen 10 oder weniger), damit die Anforderung fortgesetzt werden kann. Wenn zu viele ungültige Elemente erkannt werden, sollten Sie versuchen, beschädigte Elemente im Quellpostfach mithilfe des Cmdlets New-MailboxRepairRequest zu reparieren, und wiederholen Sie die Anforderung.

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

Der Parameter CompletedRequestAgeLimit gibt an, wie lange die Anforderung nach Abschluss aufbewahrt wird, bevor sie automatisch entfernt wird. Der Standardwert für diesen Parameter ist 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

Die Option "Confirm" gibt an, ob die Bestätigungsaufforderung angezeigt oder ausgeblendet werden soll. Wie sich diese Option auf das Cmdlet auswirkt, hängt davon ab, ob für das Cmdlet eine Bestätigung erforderlich ist, bevor Sie fortfahren.

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 die Angabe des Bestätigungsschalters ohne Wert zu einer Pause, die Sie zwingt, den Befehl zu bestätigen, bevor Sie fortfahren.

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

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

Der Parameter Folders gibt die öffentlichen Ordner an, die Sie verschieben möchten. Wenn der öffentliche Ordner untergeordnete öffentliche Ordner enthält, werden diese untergeordneten öffentlichen Ordner nicht verschoben, es sei denn, Sie geben sie explizit im Befehl an. 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

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

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

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

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

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 der Standardwert.
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

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 Cmdlets "Remove-*Request" 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

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

Wenn Sie diesen Schalter verwenden, wird die Anforderung in die Warteschlange eingereiht, aber sie erreicht erst den Status InProgress, wenn Sie die Anforderung mit dem entsprechenden Lebenslauf-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

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

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Schalter SuspendWhenReadyToComplete gibt an, ob die Anforderung angehalten werden soll, bevor sie den Status 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

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

Der Schalter "WhatIf" zeigt die Funktion des Befehls an, ohne Änderungen vorzunehmen. 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

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.

Feedback

War diese Seite hilfreich?