New-PublicFolderMigrationRequest

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet New-PublicFolderMigrationRequest para iniciar una migración de carpetas públicas serie desde Exchange Server 2010.

Nota: La compatibilidad con la migración en serie de carpetas públicas finalizó en la actualización acumulativa 8 (CU8) de Exchange 2013 y los cmdlets ya no están disponibles en Exchange Online. En su lugar, use los cmdlets *-MigrationBatch y *-PublicFolderMailboxMigration* correspondientes.

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

New-PublicFolderMigrationRequest
   [[-Name] <String>]
   -SourceDatabase <DatabaseIdParameter>
   [-AcceptLargeDataLoss]
   [-BadItemLimit <Unlimited>]
   [-BatchName <String>]
   [-CompletedRequestAgeLimit <Unlimited>]
   [-Confirm]
   [-CSVData <Byte[]>]
   [-CSVStream <Stream>]
   [-DomainController <Fqdn>]
   [-InternalFlags <InternalMrsFlag[]>]
   [-LargeItemLimit <Unlimited>]
   [-MigrationMailbox <MailboxIdParameter>]
   [-Priority <RequestPriority>]
   [-RequestExpiryInterval <Unlimited>]
   [-SkipMerging <SkippableMergeComponent[]>]
   [-SourceEndpoint <MigrationEndpointIdParameter>]
   [-Suspend]
   [-SuspendComment <String>]
   [-WhatIf]
   [-WorkloadType <RequestWorkloadType>]
   [<CommonParameters>]

Description

El proceso de migración de carpetas públicas consta de varios pasos. Para obtener más información antes de intentar una migración de carpetas públicas, consulte Uso de la migración en serie para migrar carpetas públicas a Exchange 2013 desde versiones anteriores.

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

New-PublicFolderMigrationRequest -SourceDatabase PFDB01 -CSVData ([System.IO.File]::ReadAllBytes('C:\PFMigration\CSVData.csv'))

En este ejemplo se crea una solicitud de migración de carpetas públicas desde la base de datos de carpetas públicas de origen de Exchange 2010 PFDB01 y se usa el archivo CSVData.csv que se creó mediante el script de Export-PublicFolderStatistics.ps1. Para obtener más información, consulte Uso de la migración en serie para migrar carpetas públicas a Exchange 2013 desde versiones anteriores.

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.

Debe usar este modificador si establece el parámetro LargeItemLimit en un valor de 51 o superior. 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 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.

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

-BatchName

El parámetro BatchName especifica un nombre descriptivo para el lote de migración de carpetas públicas. Puede usar el parámetro BatchName como cadena de búsqueda cuando use el cmdlet Get-PublicFolderMigrationRequest.

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

-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

-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 2013, Exchange Server 2016, Exchange Server 2019

-CSVData

El parámetro CSVData especifica la salida del archivo de asignación generada por el script PublicFoldertoMailboxMapGenerator.ps1. Utilice este parámetro para las migraciones locales.

Un valor válido para este parámetro requiere que lea el archivo en un objeto codificado en bytes mediante la sintaxis siguiente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Puede usar este comando como valor de parámetro o puede escribir la salida en una variable ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) y usar la variable como valor del parámetro ($data).

No puede usar este parámetro con el parámetro CSVStream, pero debe usarlo si no usa CSVStream.

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

-CSVStream

El parámetro CSVStream especifica la salida del archivo de asignación generada por el script PublicFoldertoMailboxMapGenerator.ps1. Utilice este parámetro para las migraciones remotas.

No puede usar este parámetro con el parámetro CSVData, pero debe usarlo si no usa CSVData.

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

-DomainController

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 2013, Exchange Server 2016, Exchange Server 2019

-InternalFlags

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.

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

-MigrationMailbox

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

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

-Name

El parámetro Name especifica el nombre de la solicitud de migración de carpeta pública. Si el valor contiene espacios, escriba el valor entre comillas (").

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Priority

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 2013, Exchange Server 2016, Exchange Server 2019

-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, introdúzcalo 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

-SkipMerging

El parámetro SkipMerging especifica si se omiten ciertas etapas de la migración de una carpeta pública para fines de depuración. No utilice este parámetro a menos que se lo indique el Servicio de soporte y atención al cliente de Microsoft o una documentación específica.

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

-SourceDatabase

El parámetro SourceDatabase especifica la base de datos de destino para las carpetas públicas. Puede usar cualquier valor que identifique la base de datos de forma exclusiva. Por ejemplo:

  • Nombre
  • Nombre completo (DN)
  • GUID
Type:DatabaseIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceEndpoint

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

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

-Suspend

El modificador Suspend especifica si se suspenderá la solicitud. No es necesario especificar un valor con este modificador.

Si usa este modificador, la solicitud se pone en la cola, pero no alcanza el estado de InProgress hasta que la reanude con el cmdlet de reanudación adecuado.

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

-SuspendComment

El parámetro SuspendComment especifica una descripción del motivo por el cual se suspendió la solicitud. Solo puede usar este parámetro si especifica el parámetro Suspend.

Type:String
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 2013, Exchange Server 2016, Exchange Server 2019

-WorkloadType

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

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

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.