Get-MoveRequest
Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.
Use el cmdlet Get-MoveRequest para ver el estado detallado de un movimiento de buzón asincrónico continuo que se inició mediante el cmdlet New-MoveRequest.
Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.
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>] Description
El criterio de búsqueda para el cmdlet Get-MoveRequest es una instrucción booleana And. Si usa varios parámetros, limita la búsqueda y reduce los resultados de búsqueda.
Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.
Ejemplos
Ejemplo 1
Get-MoveRequest -Identity 'tony@contoso.com'En este ejemplo se recupera el estado del movimiento del buzón en curso para el buzón de Tony Smith (tony@contoso.com).
Ejemplo 2
Get-MoveRequest -MoveStatus InProgress -TargetDatabase DB05Este ejemplo recupera el estado del movimiento actual de buzones a la base de datos de destino DB05.
Ejemplo 3
Get-MoveRequest -BatchName "FromDB01ToDB02" -MoveStatus CompletedWithWarningEste ejemplo recupera el estado de las solicitudes de movimiento en el lote FromDB01ToDB02 que se completó, pero que tenían advertencias.
Parámetros
-BatchName
El parámetro BatchName especifica el nombre que se asignó a una solicitud de movimiento de lote.
Nombre de la base de datos
| 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
Este parámetro solo está disponible en Exchange local.
El parámetro Credential especifica el nombre de usuario y la contraseña que se usan para ejecutar este comando. Por lo general, este parámetro se usa en scripts o cuando deben proporcionarse credenciales diferentes que disponen de los permisos necesarios.
Un valor para este parámetro requiere el cmdlet Get-Credential. Para pausar este comando y recibir una solicitud de credenciales, use el valor (Get-Credential). O bien, antes de ejecutar este comando, almacene las credenciales en una variable (por ejemplo, $cred = Get-Credential) y, a continuación, use el nombre de variable ($cred) para este parámetro. Para más información, vea 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
Este parámetro solo está disponible en Exchange local.
El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, 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
El parámetro Flags especifica el tipo de movimiento para el cual se recupera la información. Puede usar los siguientes valores:
- CrossOrg
- HighPriority
- IntraOrg
- Unirse
- MoveOnlyArchiveMailbox
- MoveOnlyPrimaryMailbox
- Ninguno
- Offline
- Protected
- Extracción
- Inserción
- RemoteLegacy
- Dividir
- Suspender
- 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
Este parámetro solo está disponible en Exchange local.
El parámetro HighPriority especifica que el cmdlet devuelve las solicitudes que se crearon con la marca HighPriority. La marca HighPriority indica que se debe procesar la solicitud antes que otras solicitudes de menor prioridad que están en la cola.
Nombre de la base de datos
| 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
El parámetro Identity especifica la identidad de la solicitud de movimiento, que es la identidad del usuario de correo o de buzón de correo. Es posible usar cualquier valor que identifique exclusivamente el buzón de correo o el usuario de correo. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre completo (DN)
- Dominio\Nombre de usuario
- Dirección de correo electrónico
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuario o nombre de la entidad de seguridad de usuario (UPN)
Puede usar este parámetro con los parámetros siguientes:
- BatchName
- HighPriority
- MoveStatus
- Offline
- Proteger
- RemoteHostName
- SourceDatabase
- Suspender
- 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
Este parámetro solo está disponible en Exchange local.
El parámetro IncludeSoftDeletedObjects especifica si se devuelven los buzones que se eliminaron de manera temporal. Este parámetro acepta $true o $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
El parámetro MoveStatus devuelve las solicitudes de movimiento en el estado especificado. Puede usar los siguientes valores:
- AutoSuspended
- Completado
- CompletedWithWarning
- CompletionInProgress
- Error
- InProgress
- En cola
- Reintentando
- Suspended
Nombre de la base de datos
| 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
El parámetro Offline especifica si se devuelven los buzones que se están moviendo en el modo sin conexión. Este parámetro acepta $true o $false.
Nombre de la base de datos
| 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
El parámetro OrganizationalUnit filtra los resultados en función de la ubicación del objeto en Active Directory. Se devuelven solo los objetos que existen en la ubicación especificada. La entrada válida para este parámetro es una unidad organizativa (UO) o dominio que devuelve el cmdlet Get-OrganizationalUnit. Puede usar cualquier valor que identifique la OU o el dominio de forma exclusiva. Por ejemplo:
- Nombre
- Nombre
- Nombre completo (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
Este parámetro solo está disponible en Exchange local.
El parámetro Protect devuelve buzones que se están moviendo en modo protegido. Este parámetro acepta $true o $false.
Nombre de la base de datos
| 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
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro ProxyToMailbox filtra los resultados por la ubicación del buzón especificado (también conocido como proxy). Es posible usar cualquier valor que identifique exclusivamente el buzón. Por ejemplo:
- Nombre
- Alias
- Nombre distintivo (DN)
- Nombre completo (DN)
- Dominio\Nombre de usuario
- Dirección de correo electrónico
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuario o nombre de la entidad de seguridad de usuario (UPN)
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-RemoteHostName
El parámetro RemoteHostName especifica el FQDN de la organización entre bosques desde la cual está moviendo el buzón de correo.
Nombre de la base de datos
| 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
El parámetro ResultSize especifica el número máximo de resultados que se van a devolver. Si desea incluir en los resultados devueltos todas las solicitudes que coincidan con la consulta, use el valor ilimitado para este parámetro. El valor predeterminado es 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
El parámetro SortBy especifica la propiedad según la cual se ordenan los resultados. Solo se puede seleccionar una propiedad a la vez. Los resultados se clasifican en orden ascendente.
Si la vista predeterminada no incluye la propiedad por la que va a ordenar, puede anexar el comando con | Format-Table -Auto Property1,Property2,...PropertyX. para crear una nueva vista que contenga todas las propiedades que desea ver. Se admiten caracteres comodín (*) en los nombres de propiedad.
Puede realizar la clasificación por las propiedades siguientes:
- Nombre
- 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
Este parámetro solo está disponible en Exchange local.
El parámetro SourceDatabase devuelve todos los buzones que se mueven de la base de datos de buzón de origen especificada. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Nombre de la base de datos
| 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
Este parámetro solo está disponible en el servicio basado en la nube.
El parámetro Status filtra los resultados por estado. Los valores admitidos son:
- AutoSuspended
- Completado
- CompletedWithSkippedItems
- CompletedWithWarning
- CompletionInProgress
- Error
- InProgress
- En cola
- Reintentando
- Suspended
- Sincronizado
| Type: | RequestStatus |
| Aliases: | MoveStatus |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Suspend
El parámetro Suspend especifica si se devolverán los buzones con movimientos que se han suspendido. Este parámetro acepta $true o $false.
Nombre de la base de datos
| 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
El parámetro SuspendWhenReadytoComplete especifica si se devolverán buzones que se han movido con el comando New-MoveRequest y su modificador SuspendWhenReadyToComplete. Este parámetro acepta $true o $false.
Nombre de la base de datos
| 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
Este parámetro solo está disponible en Exchange local.
El parámetro TargetDatabase devuelve todos los buzones que se mueven a la base de datos de buzón de destino especificada. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:
- Nombre
- Nombre completo (DN)
- GUID
Nombre de la base de datos
| 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 |
Entradas
Input types
Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.
Salidas
Output types
Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.