Get-MoveRequest

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 Get-MoveRequest, um den detaillierten Status einer laufenden asynchronen Postfachverschiebung anzuzeigen, die mithilfe des Cmdlets New-MoveRequest initiiert wurde.

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

Syntax

Identity

Get-MoveRequest
    [[-Identity] <MoveRequestIdParameter>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [-IncludeSoftDeletedObjects]
    [-ProxyToMailbox <MailboxIdParameter>]
    [<CommonParameters>]

Filtering

Get-MoveRequest
    [-BatchName <String>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Flags <RequestFlags>]
    [-HighPriority <Boolean>]
    [-IncludeSoftDeletedObjects]
    [-MoveStatus <RequestStatus>]
    [-Offline <Boolean>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-Protect <Boolean>]
    [-ProxyToMailbox <MailboxIdParameter>]
    [-RemoteHostName <Fqdn>]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [-SourceDatabase <DatabaseIdParameter>]
    [-Status <RequestStatus>]
    [-Suspend <Boolean>]
    [-SuspendWhenReadyToComplete <Boolean>]
    [-TargetDatabase <DatabaseIdParameter>]
    [<CommonParameters>]

Beschreibung

Bei den Suchkriterien für das Cmdlet Get-MoveRequest handelt es sich um eine boolesche And-Anweisung. Wenn Sie mehrere Parameter verwenden, können Sie die Suche einschränken und somit die Anzahl von Suchergebnissen reduzieren.

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

Get-MoveRequest -Identity 'tony@contoso.com'

In diesem Beispiel wird die status der laufenden Postfachverschiebung für das Postfach von Tony Smith (tony@contoso.com) abgerufen.

Beispiel 2

Get-MoveRequest -MoveStatus InProgress -TargetDatabase DB05

In diesem Beispiel wird der Status von laufenden Postfachverschiebungen in die Zieldatenbank "DB05" abgerufen.

Beispiel 3

Get-MoveRequest -BatchName "FromDB01ToDB02" -MoveStatus CompletedWithWarning

In diesem Beispiel wird der Status von Verschiebungsanforderungen im Batch "FromDB01ToDB02" abgerufen, die abgeschlossen sind, aber Warnungen aufweisen.

Parameter

-BatchName

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

Der Parameter BatchName gibt den Namen an, der einer Batchverschiebungsanforderung zugeordnet wurde.

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Credential

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

Dieser Parameter ist nur im lokalen Exchange verfügbar.

Der Parameter Credential gibt den Benutzernamen und das Kennwort an, die zum Ausführen dieses Befehls verwendet werden. Normalerweise verwenden Sie diesen Parameter in Skripts oder wenn Sie unterschiedliche Anmeldeinformationen bereitstellen müssen, die über die erforderlichen Berechtigungen verfügen.

Ein Wert für diesen Parameter setzt das Cmdlet "Get-Credential" voraus. Verwenden Sie den Wert (Get-Credential), um diesen Befehl anzuhalten und eine Aufforderung zur Eingabe von Anmeldeinformationen zu erhalten. Oder speichern Sie die Anmeldeinformationen in einer Variablen (beispielsweise $cred = Get-Credential), bevor Sie diesen Befehl ausführen, und verwenden Sie dann den Variablennamen ($cred) für diesen Parameter. Weitere Informationen finden Sie unter Get-Credential.

Parametereigenschaften

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

-DomainController

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

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

-Flags

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

Der Parameter Flags gibt den Verschiebungstyp an, für den Informationen abgerufen werden sollen. Der gültige Wert ist:

• CrossOrg
• HighPriority
• IntraOrg
• Join
• MoveOnlyArchiveMailbox
• MoveOnlyPrimaryMailbox
• Keine
• Offline
• Geschützt
• Pull
• Push
• RemoteLegacy
• Split
• Aufhängen
• SuspendWhenReadyToComplete
• TargetIsAggregatedMailbox

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-HighPriority

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

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter HighPriority gibt an, dass das Cmdlet Anforderungen zurückgibt, die mit dem Flag HighPriority erstellt wurden. Das Flag HighPriority gibt an, dass die Anforderung vor anderen Anforderungen mit einer niedrigeren Priorität in der Warteschlange verarbeitet werden soll.

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Identity

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

Der Identity-Parameter gibt die Identität der Verschiebungsanforderung an, die die Identität des Postfachs oder des Postfachbenutzers ist. Sie können jeden beliebigen Wert verwenden, sofern er das Postfach oder den E-Mail-Benutzer eindeutig kennzeichnet. Zum 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)

Sie können diesen Parameter nicht zusammen mit den folgenden Parametern verwenden:

• BatchName
• HighPriority
• MoveStatus
• Offline
• Schützen
• RemoteHostName
• SourceDatabase
• Aufhängen
• SuspendWhenReadyToComplete
• TargetDatabase

Parametereigenschaften

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

Parametersätze

Identity

Position:	1
Obligatorisch.:	False
Wert aus Pipeline:	True
Wert aus Pipeline nach dem Eigenschaftsnamen:	True
Wert aus verbleibenden Argumenten:	False

-IncludeSoftDeletedObjects

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

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter IncludeSoftDeletedObjects gibt an, ob Postfächer zurückgegeben werden, die nicht dauerhaft gelöscht wurden. Dieser Parameter akzeptiert $true oder $false.

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

-MoveStatus

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

Der Parameter MoveStatus gibt Verschiebungsanforderungen im angegebenen Status zurück. Folgende Werte können verwendet werden:

• AutoSuspended
• Abgeschlossen
• CompletedWithWarning
• CompletionInProgress
• Fehlgeschlagen
• InProgress
• In Warteschlange eingereiht
• Wiederholung
• Gesperrt

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Offline

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

Der Parameter Offline gibt an, ob Postfächer zurückgegeben werden sollen, die in den Offlinemodus verschoben werden. Dieser Parameter akzeptiert $true oder $false.

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-OrganizationalUnit

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

Der OrganizationalUnit-Parameter filtert die Ergebnisse basierend auf dem Speicherort des Objekts in Active Directory. Es werden nur Objekte zurückgegeben, die am angegebenen Speicherort vorhanden sind. Eine gültige Eingabe für diesen Parameter ist eine Organisationseinheit (OU) oder Domäne, die vom Cmdlet Get-OrganizationalUnit zurückgegeben wird. Sie können jeden beliebigen Wert verwenden, sofern er die Organisationseinheit oder Domäne eindeutig kennzeichnet. Beispiel:

• Name
• Name
• Distinguished Name (DN)
• GUID

Parametereigenschaften

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

-Protect

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

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter Protect gibt Postfächer zurück, die im geschützten Modus verschoben werden. Dieser Parameter akzeptiert $true oder $false.

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-ProxyToMailbox

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Parameter ProxyToMailbox filtert die Ergebnisse anhand des Speicherorts des angegebenen Postfachs an (auch als Proxy bezeichnet). 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.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-RemoteHostName

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

Der Parameter "RemoteHostName" gibt den vollqualifizierten Domänennamen (FQDN) der gesamtstrukturübergreifenden Organisation an, aus der Sie das Postfach verschieben.

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-ResultSize

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

Der ResultSize-Parameter gibt die maximale Anzahl von zurückzugebenden Ergebnissen an. Wenn Sie alle Anforderungen zurückgeben möchten, die der Abfrage entsprechen, verwenden Sie unlimited als Wert für diesen Parameter. Der Standardwert ist 1000.

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

-SortBy

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

Der Parameter SortBy gibt die Eigenschaft an, nach der die Ergebnisse sortiert werden sollen. Sie können die Sortierung nur jeweils nach einer Eigenschaft vornehmen. Die Ergebnisse werden in absteigender Reihenfolge sortiert.

Wenn die Standardansicht die Eigenschaft, nach der Sie sortieren, nicht enthält, können Sie den Befehl mit | Format-Table -Auto Property1,Property2,...PropertyX anhängen. um eine neue Ansicht zu erstellen, die alle Eigenschaften enthält, die Sie sehen möchten. Platzhalter (*) in den Eigenschaftsnamen werden unterstützt.

Nach den folgende Eigenschaften kann sortiert werden:

• Name
• DisplayName
• Alias

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

-SourceDatabase

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

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter SourceDatabase gibt alle Postfächer zurück, die aus der angegebenen Quellpostfachdatenbank verschoben werden. Sie können jeden beliebigen Wert verwenden, sofern er die Datenbank eindeutig kennzeichnet. Beispiel:

• Name
• Distinguished Name (DN)
• GUID

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Status

Anwendbar: Exchange Online

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

Der Status-Parameter filtert die Ergebnisse nach status. Gültige Werte sind:

• AutoSuspended
• Abgeschlossen
• CompletedWithSkippedItems
• CompletedWithWarning
• CompletionInProgress
• Fehlgeschlagen
• InProgress
• In Warteschlange eingereiht
• Wiederholung
• Gesperrt
• Synchronisiert

Parametereigenschaften

Typ:	RequestStatus
Standardwert:	None
Unterstützt Platzhalter:	False
Nicht anzeigen:	False
Aliase:	MoveStatus

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-Suspend

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

Der Parameter Suspend gibt an, ob Postfächer mit angehaltenen Verschiebungen zurückgegeben werden. Dieser Parameter akzeptiert $true oder $false.

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-SuspendWhenReadyToComplete

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

Der Parameter SuspendWhenReadytoComplete gibt an, ob Postfächer zurückgegeben werden sollen, die mit dem Befehl New-MoveRequest und der zugehörigen Option SuspendWhenReadyToComplete verschoben wurden. Dieser Parameter akzeptiert $true oder $false.

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

Position:	Named
Obligatorisch.:	False
Wert aus Pipeline:	False
Wert aus Pipeline nach dem Eigenschaftsnamen:	False
Wert aus verbleibenden Argumenten:	False

-TargetDatabase

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

Dieser Parameter ist im lokalen Exchange verfügbar.

Der Parameter TargetDatabase gibt alle Postfächer zurück, die in die angegebene Zielpostfachdatenbank verschoben werden. Sie können jeden beliebigen Wert verwenden, sofern er die Datenbank eindeutig kennzeichnet. Beispiel:

• Name
• Distinguished Name (DN)
• GUID

Sie können diesen Parameter nicht zusammen mit dem Identity-Parameter verwenden.

Parametereigenschaften

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

Parametersätze

Filtering

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.