Freigeben über


Get-MoveRequest

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

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

Get-MoveRequest
   [[-Identity] <MoveRequestIdParameter>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [-IncludeSoftDeletedObjects]
   [-ProxyToMailbox <MailboxIdParameter>]
   [<CommonParameters>]
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. 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

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

In diesem Beispiel wird der 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

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

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

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

-Credential

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.

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

-DomainController

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.

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

-Flags

Der Parameter Flags gibt den Verschiebungstyp an, für den Informationen abgerufen werden sollen. Die folgenden Werte können verwendet werden:

  • CrossOrg
  • HighPriority
  • IntraOrg
  • Beitreten
  • MoveOnlyArchiveMailbox
  • MoveOnlyPrimaryMailbox
  • Keine
  • Offline
  • Geschützt
  • Pull
  • Push
  • RemoteLegacy
  • Teilung
  • Auszusetzen
  • SuspendWhenReadyToComplete
  • TargetIsAggregatedMailbox
Type:RequestFlags
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, Exchange Online

-HighPriority

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.

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

-Identity

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
  • Auszusetzen
  • SuspendWhenReadyToComplete
  • Targetdatabase
Type:MoveRequestIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IncludeSoftDeletedObjects

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.

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

-MoveStatus

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.

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

-Offline

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.

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

-OrganizationalUnit

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
Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Protect

Dieser Parameter ist nur 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.

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

-ProxyToMailbox

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)
Type:MailboxIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RemoteHostName

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.

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

-ResultSize

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.

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

-SortBy

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
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceDatabase

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.

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

-Status

Dieser Parameter ist nur im cloudbasierten Dienst verfügbar.

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

  • AutoSuspended
  • Abgeschlossen
  • CompletedWithSkippedItems
  • CompletedWithWarning
  • CompletionInProgress
  • Fehlgeschlagen
  • InProgress
  • In Warteschlange eingereiht
  • Wiederholung
  • Gesperrt
  • Synchronisiert
Type:RequestStatus
Aliases:MoveStatus
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Suspend

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.

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

-SuspendWhenReadyToComplete

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.

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

-TargetDatabase

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.

Type:DatabaseIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, 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.