New-PublicFolderMoveRequest
Este cmdlet solo está disponible en el entorno local de Exchange.
El cmdlet New-PublicFolderMoveRequest permite comenzar el proceso de movimiento del contenido de carpetas públicas entre buzones de carpetas públicas. Al mover una carpeta pública, solo se mueve su contenido físico, la jerarquía lógica sigue siendo la misma. Después de completarse la solicitud de movimiento, ejecute el cmdlet Remove-PublicFolderMoveRequest para quitar la solicitud o espere hasta que finalice el tiempo especificado en el parámetro CompletedRequestAgeLimit. La solicitud debe quitarse para poder ejecutar otra solicitud de movimiento.
Tenga en cuenta que el buzón de la carpeta pública de destino se bloqueará mientras esté activa la solicitud de traslado. Para obtener más información, consulte la sección Descripción.
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-PublicFolderMoveRequest
-Folders <PublicFolderIdParameter[]>
-TargetMailbox <MailboxIdParameter>
[-AcceptLargeDataLoss]
[-AllowLargeItems]
[-BadItemLimit <Unlimited>]
[-CompletedRequestAgeLimit <Unlimited>]
[-Confirm]
[-DomainController <Fqdn>]
[-InternalFlags <InternalMrsFlag[]>]
[-Name <String>]
[-Priority <RequestPriority>]
[-RequestExpiryInterval <Unlimited>]
[-Suspend]
[-SuspendComment <String>]
[-SuspendWhenReadyToComplete]
[-WhatIf]
[-WorkloadType <RequestWorkloadType>]
[<CommonParameters>]
Description
El cmdlet New-PublicFolderMoveRequest permite mover las carpetas públicas de un buzón de carpetas públicas de origen a otro de destino. Mientras la solicitud de traslado esté activa, el buzón de la carpeta pública de destino se bloqueará. Como resultado, no se podrá acceder a las carpetas públicas que residen ya en el buzón de la carpeta pública de destino hasta que se complete la solicitud de traslado. Por lo tanto, antes de comenzar la solicitud de traslado, debe asegurarse de que ningún usuario tenga acceso a los datos de carpetas públicas en ese buzón de carpeta pública de destino.
Para mover el buzón de carpetas públicas a otra base de datos de buzones, use el cmdlet New-MoveRequest. Para comprobar que esta carpeta ya se encuentra en el buzón de carpetas públicas de destino, ejecute el cmdlet Update-PublicFolderMailbox en el buzón de carpetas públicas de destino. Solo se puede realizar una solicitud de movimiento a la vez. También puede mover carpetas públicas mediante el script Move-PublicFolderBranch.ps1.
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-PublicFolderMoveRequest -Folders \DeveloperReports\CustomerEngagements -TargetMailbox DeveloperReports01
En este ejemplo se inicia la solicitud de movimiento para la carpeta pública \CustomerEngagements desde el buzón de carpetas públicas DeveloperReports hasta DeveloperReports01.
Ejemplo 2
New-PublicFolderMoveRequest -Folders \Dev\CustomerEngagements,\Dev\RequestsforChange,\Dev\Usability -TargetMailbox DeveloperReports01
En este ejemplo se inicia la solicitud de movimiento de las carpetas públicas de la rama \Dev al buzón de carpetas públicas de destino DeveloperReports01.
También puede mover una rama de carpetas públicas mediante el script Move-PublicFolderBranch.ps1.
Ejemplo 3
$folders = Get-PublicFolder \ -Recurse -Mailbox PUB1 -ResidentFolders | ?{$_.Name -ne "IPM_SUBTREE"} | %{$_.Identity}
New-PublicFolderMoveRequest -TargetMailbox PUB2 -Folders $folders
En este ejemplo se mueven todas las carpetas públicas del buzón de carpeta pública Pub1 al buzón de carpeta pública Pub2.
Parámetros
-AcceptLargeDataLoss
El modificador AcceptLargeDataLoss especifica que la solicitud debe continuar incluso si no se puede copiar un gran número de elementos en el buzón de origen en el 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 |
-AllowLargeItems
El modificador AllowLargeItems especifica que solo se pueden mover elementos grandes cuando se encuentran. No es necesario especificar un valor con este modificador.
Los elementos grandes son mensajes de correo electrónico con un máximo de 1.023 datos adjuntos.
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 pueden encontrar 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 en la solicitud si se detecta algún elemento incorrecto. Si está de acuerdo con dejar algunos elementos incorrectos atrás, puede establecer este parámetro en un valor razonable (se recomienda 10 o inferior) 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, a continuación, vuelva 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 |
-CompletedRequestAgeLimit
El parámetro CompletedRequestAgeLimit especifica cuánto tiempo se conservará la solicitud después de que se haya completado antes de quitarse automáticamente. El valor predeterminado de este parámetro 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 |
-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 |
-Folders
El parámetro Folders especifica las carpetas públicas que desea mover. Si la carpeta pública tiene carpetas públicas secundarias, estas carpetas públicas secundarias no se moverán a menos que las indique explícitamente en el comando. Puede mover varias carpetas públicas separándolas con una coma, por ejemplo, \Dev\CustomerEngagements,\Dev\RequestsforChange,\Dev\Usability.
Type: | PublicFolderIdParameter[] |
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 |
-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 |
-Name
El parámetro Name especifica el nombre de la solicitud de movimiento de carpetas públicas. Si no especifica ningún nombre, el nombre predeterminado es PublicFolderMove.
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 |
-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, 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 |
-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 |
-SuspendWhenReadyToComplete
El modificador SuspendWhenReadyToComplete especifica si se suspende la solicitud antes de que alcance el estado CompletionInProgress. No es necesario especificar un valor con este modificador.
Después de suspender el movimiento, tiene el estado AutoSuspended. Puede completar manualmente el movimiento mediante el comando Resume-PublicFolderMoveRequest.
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 |
-TargetMailbox
El parámetro TargetMailbox especifica el buzón de carpetas públicas de destino al que desea mover las carpetas públicas. 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: | True |
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
El parámetro WorkloadType está reservado para el 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.