Compartir a través de

Get-MoveRequest

Módulo:
Exchange PowerShell

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Algunos parámetros y configuraciones pueden ser 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.

Sintaxis

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>]

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 artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. 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

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

El parámetro BatchName especifica el nombre que se asignó a una solicitud de movimiento de lote.

Nombre de la base de datos

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Credential

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

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.

Propiedades de parámetro

Tipo:PSCredential
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainController

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

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.

Propiedades de parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Flags

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

El parámetro Flags especifica el tipo de movimiento para el cual se recupera la información. Los valores válidos son:

  • CrossOrg
  • HighPriority
  • IntraOrg
  • Unirse
  • MoveOnlyArchiveMailbox
  • MoveOnlyPrimaryMailbox
  • Ninguno
  • Offline
  • Protected
  • Extracción
  • Inserción
  • RemoteLegacy
  • Dividir
  • Suspender
  • SuspendWhenReadyToComplete
  • TargetIsAggregatedMailbox

Propiedades de parámetro

Tipo:RequestFlags
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-HighPriority

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

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

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

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

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

Precaución: El valor $null o un valor inexistente para el parámetro Identity devuelve todos los objetos como si ejecutara el comando Get- sin el parámetro Identity. Compruebe que las listas de valores del parámetro Identity son precisas y no contienen valores $null inexistentes.

Propiedades de parámetro

Tipo:MoveRequestIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:1
Obligatorio:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IncludeSoftDeletedObjects

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

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.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-MoveStatus

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

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

Propiedades de parámetro

Tipo:RequestStatus
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Offline

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

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

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-OrganizationalUnit

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

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

Propiedades de parámetro

Tipo:OrganizationalUnitIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Protect

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

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

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ProxyToMailbox

Aplicable: Exchange Online

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)

Propiedades de parámetro

Tipo:MailboxIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoteHostName

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

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

Propiedades de parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResultSize

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

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.

Propiedades de parámetro

Tipo:Unlimited
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SortBy

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

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

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SourceDatabase

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

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

Propiedades de parámetro

Tipo:DatabaseIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Status

Aplicable: Exchange Online

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

Propiedades de parámetro

Tipo:RequestStatus
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:MoveStatus

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Suspend

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

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

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-SuspendWhenReadyToComplete

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

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

Propiedades de parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-TargetDatabase

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

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

Propiedades de parámetro

Tipo:DatabaseIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Filtering
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

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.