Upgrade-SPSite

Referencia

Módulo:: SharePointServer

Se aplica a:: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Empieza el proceso de actualización en una colección de sitios.

Syntax

Upgrade-SPSite
       [-Identity] <SPSitePipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Email]
       [-QueueOnly]
       [-Unthrottled]
       [-VersionUpgrade]
       [-WhatIf]
       [-Priority <Byte>]
       [<CommonParameters>]

Description

El Upgrade-SPSite cmdlet inicia el proceso de actualización en una colección de sitios.

El Upgrade-SPSite cmdlet activa el proceso de actualización del objeto SPSite especificado. También puede usar este cmdlet para reanudar actualizaciones que han producidor errores. Si usa este cmdlet para iniciar actualizaciones en un objeto SPSite, el objeto puede ser una actualización de una compilación a otra o de una versión a otra.

De forma predeterminada, el Upgrade-SPSite cmdlet funciona como una actualización de compilación a compilación. De este modo, se evitan actualizaciones de versión inesperadas de colecciones de sitios cuando se usa este cmdlet tras una acción de revisión. En modo actualización de versión a versión, las comprobaciones de mantenimiento de la colección de sitios se ejecutan en modo de reparación para garantizar que el estado de la colección sea suficientemente correcto para que la actualización se haga sin problemas. Si es correcto, se hace el resto de la actualización.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

-------------EJEMPLO 1----------

Upgrade-SPSite https://<site name>/sites/testsite

En este ejemplo se actualiza la colección de sitios de https://< site> name/sites/testsite existente utilizando solo las acciones de actualización de compilación a compilación disponibles asociadas al modo operativo de la colección de sitios actual. Esta acción no cambia el valor de SPSite.CompatibilityLevel.

-------------EJEMPLO 2----------

Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade

En este ejemplo se actualiza la colección de sitios de https://< site name>/sites/testsite existente mediante todas las acciones de actualización de compilación a compilación disponibles asociadas al modo operativo de la colección de sitios actual y se realiza una actualización de versión a versión.

Parámetros

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Email

Especifica si se enviará un correo al completarse la actualización de la colección de sitios.

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

-Identity

Especifica el objeto SPSite en el que se inician las acciones de actualización.

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

-Priority

Especifica la prioridad para actualizar el sitio.

Los valores válidos son:

128-255 (prioridad baja)
11-127 (prioridad normal)
0-10 (prioridad alta)

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

-QueueOnly

Especifica que se coloque el sitio en la cola para una actualización retrasada administrada por un trabajo de temporizador.

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

-Unthrottled

Especifica un administrador de granjas para omitir la limitación, lo que permite que una colección de sitios se actualice incluso si hay "demasiadas" colecciones en para actualizarse.

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

-VersionUpgrade

Especifica que se debe hacer una actualización de versión a versión en el objeto SPSite. Si se establece este parámetro, desencadena internamente todas las acciones de compilación a compilación disponibles asociadas con el modo de funcionamiento de colección de sitio actual. Las acciones de versión a versión llevan las colecciones de sitios al siguiente modo de funcionamiento de colección de sitio, incluyendo todas las acciones nuevas de compilación a compilación asociadas con el nuevo modo de funcionamiento de colección de sitio. Si este parámetro no se establece, desencadena solo las acciones de actualización de compilación a compilación asociadas con el modo de funcionamiento de colección de sitio actual.

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

-WhatIf

Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando. Para obtener más información, escriba el siguiente comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019