Compartir a través de


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 DB05

Este ejemplo recupera el estado del movimiento actual de buzones a la base de datos de destino DB05.

Ejemplo 3

Get-MoveRequest -BatchName "FromDB01ToDB02" -MoveStatus CompletedWithWarning

Este 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.