Compartir a través de


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

Utilice el cmdlet Set-MoveRequest para cambiar las opciones de solicitud de movimiento después de haber creado la solicitud de movimiento. Puede usar el cmdlet Set-MoveRequest para recuperar solicitudes de movimiento con errores.

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

Set-MoveRequest
   [-Identity] <MoveRequestIdParameter>
   [-AcceptLargeDataLoss]
   [-ArchiveTargetDatabase <DatabaseIdParameter>]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompleteAfter <DateTime>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-IgnoreRuleLimitErrors <Boolean>]
   [-IncrementalSyncInterval <TimeSpan>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-MoveOptions <MultiValuedProperty>]
   [-PreventCompletion <Boolean>]
   [-Priority <RequestPriority>]
   [-Protect <Boolean>]
   [-ProxyToMailbox <MailboxIdParameter>]
   [-RemoteCredential <PSCredential>]
   [-RemoteGlobalCatalog <Fqdn>]
   [-RemoteHostName <Fqdn>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMoving <SkippableMoveComponent[]>]
   [-SkippedItemApprovalTime <DateTime>]
   [-StartAfter <DateTime>]
   [-SuspendWhenReadyToComplete <Boolean>]
   [-TargetDatabase <DatabaseIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Description

Puede canalizar el cmdlet Set-MoveRequest desde los cmdlets Get-MoveRequestStatistics, Get-MoveRequest o Get-Mailbox.

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

Set-MoveRequest -Identity Ayla@humongousinsurance.com -BadItemLimit 5

En este ejemplo se cambia la solicitud de movimiento para Vanessa para que acepte hasta cinco elementos dañados de buzón.

Ejemplo 2

Set-MoveRequest -Identity Sruthi@contoso.com -SkippedItemApprovalTime $(Get-Date).ToUniversalTime()

En este ejemplo se cambia la solicitud de movimiento de Sruthi para aprobar todos los elementos omitidos encontrados antes de la hora actual.

Parámetros

-AcceptLargeDataLoss

El modificador AcceptLargeDataLoss especifica que la solicitud debe continuar aunque no se pueda copiar un gran número de elementos del buzón de origen al buzón de destino. No es necesario especificar un valor con este modificador.

En Exchange 2013 o posterior, o en Exchange Online, necesita usar este modificador si establece el parámetro LargeItemLimit en un valor de 51 o más. De lo contrario, se producirá un error en el comando.

En Exchange 2010, debe usar este modificador si establece el parámetro BadItemLimit en un valor de 51 o más. De lo contrario, se producirá un error en el comando.

Type:SwitchParameter
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

-ArchiveTargetDatabase

Este parámetro solo está disponible en Exchange local.

El parámetro ArchiveTargetDatabase especifica la base de datos de buzón de correo de destino para el archivo personal. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Solo puede usar este parámetro para cambiar la base de datos de destino si la solicitud de movimiento tiene un valor MoveStatus de Queued.

Type:DatabaseIdParameter
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

-BadItemLimit

El parámetro BadItemLimit especifica el número máximo de elementos incorrectos que se permiten antes de que se produzca un error en la solicitud. Un elemento incorrecto es un elemento dañado en el buzón de origen no se puede copiar en el buzón de destino. También se incluyen los elementos que faltan en el límite de elementos incorrectos. Los elementos que faltan son elementos del buzón de origen que no se encuentran en el buzón de destino cuando la solicitud está lista para completarse.

La entrada válida para este parámetro es un número entero o el valor Unlimited. El valor predeterminado es 0, lo que significa que se producirá un error si se detectan elementos incorrectos. Si le parece bien dejar rezagados algunos elementos incorrectos, puede establecer este parámetro en un valor razonable (se recomienda 10 o menos) para que la solicitud pueda continuar. Si se detectan demasiados elementos incorrectos, considere la posibilidad de usar el cmdlet New-MailboxRepairRequest para intentar corregir los elementos dañados en el buzón de origen y volver a intentar la solicitud.

En Exchange 2010, si establece este valor en 51 o más, también deberá utilizar el modificador AcceptLargeDataLoss. De lo contrario, se producirá un error en el comando.

Nota: Este parámetro está obsoleto en el servicio basado en la nube. En el futuro, si no usa este parámetro, se usará la semántica de aprobación de Skipped Item en su lugar.

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

-BatchName

El parámetro BatchName especifica un nombre diferente para el lote.

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

-CompleteAfter

El parámetro CompleteAfter especifica un retraso antes de que se complete la solicitud. La solicitud se ha iniciado, pero no finaliza hasta la fecha y hora que especifique para este parámetro.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

En Exchange Online PowerShell, si especifica un valor de fecha y hora sin una zona horaria, el valor está en hora universal coordinada (UTC).

Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:

  • Especifique el valor de fecha y hora en UTC: por ejemplo, "2021-05-06 14:30:00z".
  • Especifique el valor de fecha y hora como una fórmula que convierta la fecha y hora de la zona horaria local en UTC: por ejemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.
Type:DateTime
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

-CompletedRequestAgeLimit

El parámetro CompletedRequestAgeLimit especifica la cantidad de tiempo que se conserva la solicitud una vez completada y antes de que se quite automáticamente. El valor predeterminado del parámetro CompletedRequestAgeLimit es 30 días.

Type:Unlimited
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

-Confirm

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

  • Los cmdlets destructivos (por ejemplo, cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
  • La mayoría de los demás cmdlets (por ejemplo, los cmdlets New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.
Type:SwitchParameter
Aliases:cf
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, Exchange Online Protection

-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

-Identity

El parámetro Identity especifica la identidad del buzón de correo o del usuario de correo. Puede usar los siguientes valores:

  • GUID
  • Nombre distintivo (DN)
  • Dominio\Cuenta
  • Nombre principal del usuario (UPN)
  • DN de Exchange heredado
  • Dirección SMTP
  • Alias
Type:MoveRequestIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

-IgnoreRuleLimitErrors

El parámetro IgnoreRuleLimitErrors especifica que el comando no moverá las reglas del usuario al servidor de destino que ejecuta Microsoft Exchange.

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

-IncrementalSyncInterval

El parámetro IncrementalSyncInterval especifica el tiempo de espera entre sincronizaciones incrementales. Este parámetro se usa junto con el parámetro CompleteAfter para crear una solicitud de movimiento que realice sincronizaciones incrementales periódicas una vez completada la sincronización inicial.

Para especificar un valor, escríbalo como un intervalo de tiempo: dd.hh:mm:ss donde dd = días, hh = horas, mm = minutos y ss = segundos.

Los valores válidos están comprendidos entre 00:00:00 y 120.00:00:00 (120 días). El valor predeterminado es 24 horas.

Type:TimeSpan
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

-InternalFlags

Este parámetro solo está disponible en Exchange local.

El parámetro InternalFlags especifica los pasos opcionales de la solicitud. Este parámetro se usa principalmente con fines de depuración.

Type:InternalMrsFlag[]
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

-LargeItemLimit

El parámetro LargeItemLimit especifica la cantidad máxima de elementos grandes que se permiten antes de que se produzca un error en la solicitud. Un elemento grande es un mensaje en el buzón de origen que supera el tamaño máximo de mensaje permitido en el buzón de destino. Si el buzón de destino no tiene un valor de tamaño máximo de mensaje configurado específicamente, se usa el valor configurado para toda la organización.

Para obtener más información sobre los valores de tamaño máximo de los mensajes, consulte los siguientes temas:

La entrada válida para este parámetro es un número entero o el valor Unlimited. El valor predeterminado es 0, lo que significa que la solicitud producirá un error si se detectan elementos grandes. Si le parece bien dejar rezagados algunos elementos grandes, puede establecer este parámetro en un valor razonable (se recomienda 10 o menos) para que la solicitud pueda continuar.

Si establece este valor en 51 o más, también deberá utilizar el modificador AcceptLargeDataLoss. De lo contrario, se producirá un error en el comando.

Nota: Este parámetro está obsoleto en el servicio basado en la nube. En el futuro, si no usa este parámetro, se usará la semántica de aprobación de Skipped Item en su lugar.

Type:Unlimited
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

-MoveOptions

El parámetro MoveOptions especifica las etapas del movimiento que desea omitir con fines de depuración. No utilice este parámetro a menos que se lo indique el Soporte técnico y el servicio al cliente de Microsoft o la documentación específica.

No utilice este parámetro con el parámetro SkipMoving.

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

-PreventCompletion

El parámetro PreventCompletion especifica si se va a ejecutar la solicitud de movimiento, pero no permitir que se complete. Los valores admitidos son:

  • $true: se ejecuta la solicitud de movimiento, pero no se puede completar. En lugar de este valor, se recomienda usar el parámetro CompleteAfter.
  • $false: este es el valor predeterminado. Se ejecuta la solicitud de traslado y se permite completarla. Si ha creado la solicitud de movimiento con los modificadores SuspendWhenReadyToComplete o PreventCompletion, establezca este parámetro en $false antes de ejecutar el cmdlet Resume-MoveRequest para completar la solicitud de movimiento.
Type:Boolean
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

-Priority

Este parámetro solo está disponible en Exchange local.

El parámetro Priority especifica el orden en el que se debe procesar esta solicitud en la cola de solicitudes. Las solicitudes se procesan en orden, según el mantenimiento, el estado, la prioridad y la hora de la última actualización. Los valores de prioridad válidos son:

  • Lowest
  • Lower
  • Low
  • Normal: este es el valor predeterminado.
  • High
  • Higher
  • Highest
  • Emergency
Type:RequestPriority
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.

Este parámetro está reservado para uso interno de Microsoft.

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 especifica el destino del desplazamiento por la ubicación del buzón de correo especificado (también conocido como conexiones de 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

-RemoteCredential

El parámetro RemoteCredential especifica el nombre de usuario y la contraseña de un administrador que tiene permiso para realizar el movimiento del buzón.

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, Exchange Online

-RemoteGlobalCatalog

El parámetro RemoteGlobalCatalog especifica el FQDN del servidor de catálogo global para el bosque remoto.

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

-RemoteHostName

El parámetro RemoteHostName especifica el FQDN de la organización entre bosques desde la cual está moviendo el buzón de correo.

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

-RequestExpiryInterval

El parámetro RequestExpiryInterval especifica un límite de edad para una solicitud completada o fallida. Cuando se usa este parámetro, la solicitud completada o fallida se elimina automáticamente después de que caduque el intervalo especificado. Si no usa este parámetro:

  • La solicitud completada se quita automáticamente en función del valor del parámetro CompletedRequestAgeLimit.
  • Si se produce un error en la solicitud, debe quitarla manualmente mediante el cmdlet Remove-*Request correspondiente.

Para especificar un valor, escríbalo como un intervalo de tiempo: dd.hh:mm:ss donde dd = días, hh = horas, mm = minutos y ss = segundos.

Cuando se usa el valor Unlimited, la solicitud completada no se quita automáticamente.

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

-SkipMoving

Este parámetro se ha sustituido por el parámetro MoveOptions.

El parámetro SkipMoving especifica las etapas del movimiento que desea omitir con fines de depuración. No utilice este parámetro a menos que se lo indique el Soporte técnico y el servicio al cliente de Microsoft o la documentación específica.

Type:SkippableMoveComponent[]
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

-SkippedItemApprovalTime

Este parámetro solo está disponible en el servicio basado en la nube.

El parámetro SkippedItemApprovalTime marca todos los elementos omitidos detectados antes de la hora especificada como aprobada. Si la pérdida de datos detectada durante esta migración es significativa, la migración no podrá completarse sin aprobar los elementos omitidos. Es posible que se hayan omitido los elementos porque están dañados en el buzón de origen y no se pueden copiar en el buzón de destino, son mayores que el tamaño máximo permitido del mensaje configurado para el inquilino o se detectaron como ausentes en el buzón de destino cuando la migración está lista para completarse.

Para obtener más información sobre los valores máximos de tamaño de mensaje, vea el tema siguiente Exchange Online Límites.

Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:

  • Especifique el valor de fecha y hora en UTC: por ejemplo, "2021-05-06 14:30:00z".
  • Especifique el valor de fecha y hora como una fórmula que convierta la fecha y hora de la zona horaria local en UTC: por ejemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.
Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-StartAfter

El parámetro StartAfter especifica un retraso antes de que se inicie la solicitud. La solicitud no se inicia hasta la fecha y hora que especifique para este parámetro.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

En Exchange Online PowerShell, si especifica un valor de fecha y hora sin una zona horaria, el valor está en hora universal coordinada (UTC).

Para especificar un valor de fecha y hora para este parámetro, use una de las siguientes opciones:

  • Especifique el valor de fecha y hora en UTC: por ejemplo, "2021-05-06 14:30:00z".
  • Especifique el valor de fecha y hora como una fórmula que convierta la fecha y hora de la zona horaria local en UTC: por ejemplo, (Get-Date "5/6/2021 9:30 AM").ToUniversalTime(). Para obtener más información, vea Get-Date.
Type:DateTime
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

-SuspendWhenReadyToComplete

El parámetro SuspendWhenReadyToComplete especifica si se suspende la solicitud de movimiento antes de alcanzar el estado de CompletionInProgress. En lugar de este parámetro, se recomienda usar el parámetro CompleteAfter.

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 especifica la base de datos de buzón de correo de destino para el buzón. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID

Solo puede usar este parámetro para cambiar la base de datos de destino si la solicitud de movimiento tiene un valor MoveStatus de Queued.

Type:DatabaseIdParameter
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

-WhatIf

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Type:SwitchParameter
Aliases:wi
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, Exchange Online Protection

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.