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 DB05In diesem Beispiel wird der Status von laufenden Postfachverschiebungen in die Zieldatenbank "DB05" abgerufen.
Beispiel 3
Get-MoveRequest -BatchName "FromDB01ToDB02" -MoveStatus CompletedWithWarningIn 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.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für