Mover buzones mediante el script MoveMailbox.ps1 en el Shell

Se aplica a: Exchange Server 2010

Última modificación del tema: 2009-12-08

Como el cmdlet Move-Mailbox de Microsoft Exchange Server 2007, el script MoveMailbox.ps1 proporciona una experiencia de administración sincrónica para mover los buzones. De forma predeterminada, los scripts se instalan en C:\Program Files\Microsoft\Exchange Server\V14\Scripts.

Nota

Puede usar este script únicamente para movimientos locales. No puede usar este script para los movimientos remotos (entre bosques). Para obtener más información sobre movimientos de buzones remotos, consulte Prepare Mailboxes for Cross-Forest Move Requests.

MoveMailbox.ps1 realiza las siguientes tareas:

1. Crea una solicitud de movimiento local.
2. Espera a que se complete el movimiento del buzón.
3. Borra la petición de movimiento una vez que se completa.

MoveMailbox.ps1 incluye dos conjuntos de parámetros. El primer conjunto de parámetros mueve un solo buzón, o usted puede canalizar varios buzones en el comando. El segundo conjunto de parámetros mueve todos los buzones alojados en una base de datos especificada, o usted puede canalizar los objetos de la base de datos en el comando para mover todos los buzones que residan en aquellas bases de datos de buzones de correo.

Nota

El Shell no carga scripts automáticamente. Todos los scripts deben estar precedidos por ".</STRONG>". Por ejemplo, para ejecutar el script MoveMailbox.ps1, escriba .\MoveMailbox.ps1.

Para obtener más información acerca de cómo usar y escribir scripts, consulte Scripting con el Shell de administración de Exchange.

¿Está buscando otras tareas de administración relacionadas con las solicitudes de movimiento? Consulte Administración de solicitudes de movimiento.

Uso de MoveMailbox.ps1 para mover buzones específicos

Deberá tener asignados permisos antes de poder llevar a cabo este procedimiento. Para ver qué permisos necesita, consulte el contenido "Movimientos de buzones de correo" en el tema Permisos de buzones.

Los siguientes conjuntos de sintaxis de parámetros y la siguiente tabla enumeran los parámetros que puede usar para mover buzones específicos.

MoveMailbox.ps1 -Identity <Object> -DatabaseMap <Hashtable> -TargetDatabase <Object> [-StartBatchSize <Int32>] [-BadItemLimit <Int32>] [-AutoSuspend] [-pollInterval <Int32>] [-DomainController <Object>]

Parámetro	Necesario	Descripción
DatabaseMap	Necesario	El parámetro DatabaseMap especifica el mapa entre las bases de datos con las que está realizando los movimientos. Use este parámetro si está usando el método de canalización para identificar los buzones de correo que está moviendo. El parámetro DatabaseMap requiere lo siguiente: Use la siguiente sintaxis: @{"<SourceDatabase>"="<TargetDatabase>"} El nombre de la SourceDatabase debe coincidir con el nombre de la base de datos informado por el cmdlet Get-Mailbox. Puede incluir varios mapas de bases de datos. Separe los distintos mapas con un punto y coma (;), por ejemplo, @{"DB1"="DBA";"DB2"="DBB"} Nota: Este parámetro no se puede usar en conjunto con el parámetro TargetDatabase. Si está canalizando el comando, y un usuario coincide con la identidad del cmdlet Get-Mailbox pero no coincide con la base de datos de origen del cmdlet DatabaseMap, se omitirá el buzón de correo de ese usuario.
Identity	Necesario	El parámetro Identity especifica la identidad del buzón que desea mover. Este parámetro acepta los valores siguientes: ADObjectID Alias Nombre distintivo (DN) Dominio\Cuenta GUID DN de Exchange heredado Dirección SMTP Nombre principal del usuario (UPN) Nota: Puede canalizar el parámetro Identity mediante el cmdlet Get-Mailbox.
TargetDatabase	Necesario	El parámetro TargetDatabase especifica la identidad de la base de datos a la que está moviendo el buzón de correo. Este parámetro acepta los valores siguientes: GUID Nombre distintivo (DN) Servidor\nombre de la base de datos Nombre de la base de datos Nota: Este parámetro no se puede usar en conjunto con el parámetro DatabaseMap.
AutoSuspend	Opcional	El modificador AutoSuspend especifica si se suspende la solicitud de movimiento antes de que alcance el estado CompletionInProgress. Después de suspender el movimiento, tiene el estado de AutoSuspended. Si usa este parámetro, debe completar el movimiento mediante el cmdlet Resume-MoveRequest.
BadItemLimit	Opcional	El parámetro BadItemLimit especifica la cantidad de elementos defectuosos que debe saltear si la solicitud de movimiento encuentra defectos en el buzón de correo. Use el valor 0 si no desea omitir elementos incorrectos. Use el valor -1 para omitir un número ilimitado de elementos incorrectos. El intervalo de entrada válido para este parámetro es de -1 a 2,147,483,647. El valor predeterminado es 0. Recomendamos que mantenga el valor predeterminado 0 y que sólo cambie el valor de parámetro BadItemLimit si falla la solicitud de movimiento.
DomainController	Opcional	El parámetro DomainController especifica el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en Active Directory.
PollInterval	Opcional	El parámetro PollInterval especifica, en segundos, la cantidad de tiempo de espera antes de verificar si una solicitud de movimiento se completó. Por ejemplo, si el PollInterval se establece en 180, el script MoveMailbox.ps1 verificará el estado de las solicitudes de movimiento cada 3 minutos para comprobar si el movimiento tiene el estado Completo. El tiempo predeterminado es de 10 segundos.
StartBatchSize	Opcional	El parámetro StartBatchSize especifica la frecuencia con que se deben iniciar los movimientos de buzones de correo para equilibrar la carga. Este parámetro únicamente se aplica cuando se mueven varios buzones de correo a la vez. Por ejemplo, si este parámetro se establece en 10 y está moviendo 15 buzones de correo, el script invocará el cmdlet New-MoveRequest cuando note que se están moviendo 10 buzones de correo a la misma base de datos de destino.

Ejemplos

EJEMPLO 1

En este ejemplo, se mueven los buzones de correo que comienzan con "ay". Si estos buzones de correo residen en la base de datos de buzones de correo DB1, en este ejemplo, se usa el parámetro DatabaseMap para moverlos a la base de datos de correo DBA. Si estos buzones de correo residen en la base de datos DB2, en este ejemplo, se los mueve a la base de datos de buzones de correo DBB.

Get-Mailbox ay* | .\MoveMailbox.ps1 -DatabaseMap @{"DB1"="DBA";"DB2"="DBB"}

EJEMPLO 2

En este ejemplo, se mueve el buzón de correo de Antonio Bermejo a DB2.

.\MoveMailbox.ps1 -Identity "Tony@Contoso.com" -TargetDatabase "DB2"

Uso de MoveMailbox.ps1 para mover buzones de correo hospedados en una base de datos específica

Deberá tener asignados permisos antes de poder llevar a cabo este procedimiento. Para ver qué permisos necesita, consulte el contenido "Movimientos de buzones de correo" en el tema Permisos de buzones.

Los siguientes conjuntos de sintaxis de parámetros y la siguiente tabla enumeran los parámetros que moverán buzones basados en la base de datos.

MoveMailbox.ps1 -MailboxDatabase <Object> [-DatabaseMap <Hashtable>] [-TargetDatabase <Object>] [-StartBatchSize <Int32>] [-BadItemLimit <Int32>] [-AutoSuspend] [-pollInterval <Int32>] [-DomainController <Object>]

Parámetro	Necesario	Descripción
MailboxDatabase	Necesario	El parámetro MailboxDatabase especifica la base de datos de buzones de correo desde la que se moverán los buzones. Este parámetro acepta los valores siguientes: GUID Nombre distintivo (DN) Servidor\nombre de la base de datos Nombre de la base de datos Nota: Este parámetro no se puede usar en conjunto con el parámetro DatabaseMap.
AutoSuspend	Opcional	El modificador AutoSuspend especifica si se suspende la solicitud de movimiento antes de que alcance el estado CompletionInProgress. Después de suspender el movimiento, tiene el estado de AutoSuspended. Si usa este parámetro, debe completar el movimiento mediante el cmdlet Resume-MoveRequest.
BadItemLimit	Opcional	El parámetro BadItemLimit especifica la cantidad de elementos defectuosos que debe saltear si la solicitud de movimiento encuentra defectos en el buzón de correo. Use el valor 0 si no desea omitir elementos incorrectos. Use el valor -1 para omitir un número ilimitado de elementos incorrectos. El intervalo de entrada válido para este parámetro es de -1 a 2,147,483,647. El valor predeterminado es 0. Recomendamos que mantenga el valor predeterminado 0 y que sólo cambie el valor de parámetro BadItemLimit si falla la solicitud de movimiento.
DatabaseMap	Opcional	El parámetro DatabaseMap especifica el mapa entre las bases de datos con las que está realizando los movimientos. Use este parámetro si está usando el método de canalización para identificar los buzones de correo que está moviendo. El parámetro DatabaseMap requiere lo siguiente: Use la siguiente sintaxis: @{"<SourceDatabase>"="<TargetDatabase>"} El nombre de la SourceDatabase debe coincidir con el nombre de la base de datos informado por el cmdlet Get-Mailbox . Puede incluir varios mapas de bases de datos. Separe los distintos mapas con un punto y coma (;), por ejemplo, @{"DB1"="DBA";"DB2"="DBB"} Nota: Este parámetro no se puede usar en conjunto con el parámetro TargetDatabase. Si está canalizando el comando, y un usuario coincide con la identidad del cmdlet Get-Mailbox pero no coincide con la base de datos de origen del cmdlet DatabaseMap, se omitirá el buzón de correo de ese usuario.
DomainController	Opcional	El parámetro DomainController especifica el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en Active Directory.
PollInterval	Opcional	El parámetro PollInterval especifica, en segundos, la cantidad de tiempo de espera antes de verificar si una solicitud de movimiento se completó. Por ejemplo, si el PollInterval se establece en 180, el script MoveMailbox.ps1 verificará el estado de las solicitudes de movimiento cada 3 minutos para comprobar si el movimiento tiene el estado Completo. El tiempo predeterminado es de 10 segundos.
StartBatchSize	Opcional	El parámetro StartBatchSize especifica la frecuencia con que se deben iniciar los movimientos de buzones de correo para equilibrar la carga. Este parámetro únicamente se aplica cuando se mueven varios buzones de correo a la vez. Por ejemplo, si este parámetro se establece en 10 y está moviendo 15 buzones de correo, el script invocará el cmdlet New-MoveRequest cuando note que se están moviendo 10 buzones de correo a la misma base de datos de destino.
TargetDatabase	Opcional	El parámetro TargetDatabase especifica la identidad de la base de datos a la que está moviendo el buzón de correo. Este parámetro acepta los valores siguientes: GUID Nombre distintivo (DN) Servidor\nombre de la base de datos Nombre de la base de datos Nota: Este parámetro no se puede usar en conjunto con el parámetro DatabaseMap.

Ejemplos

EJEMPLO 1

En este ejemplo, se mueven todos los buzones que residen en la base de datos de buzones de correo DB1 a la base de datos DB2.

.\MoveMailbox.ps1 -MailboxDatabase DB1 -TargetDatabase DB2

EJEMPLO 2

En este ejemplo, se usa el cmdlet Get-MailboxDatabase para recuperar todos los objetos de bases de datos de buzones de correo cuya base de datos de buzones de correo comienza con "DB1" y, a continuación, canaliza el resultado al script MoveMailbox.ps1.

Get-MailboxDatabase DB1* | .\MoveMailbox.ps1 -DatabaseMap @{"DB10"=DBA;"DB11"="DBB";"DB12"="DBA"}