Restaurar las personalizaciones en SharePoint Server

Artículo
03/08/2023

SE APLICA A: yes-img-13 2013 yes-img-16 2016 yes-img-19 2019 yes-img-se Subscription Edition no-img-sop SharePoint en Microsoft 365

Puede restaurar cualquier personalización realizada a SharePoint Server con Administración central o PowerShell. La herramienta de restauración que utilice, depende del tipo de entorno que haya implementado, los requisitos de programación y los acuerdos de nivel de servicio que haya realizado con su organización.

Antes de empezar

Antes de empezar esta operación, revise la información siguiente:

Se recomienda que conserve una copia de seguridad del archivo .wsp original, así como del código fuente que se usó para generar el archivo .wsp para las soluciones de confianza y de espacio aislado.

Restauración de paquetes de solución en SharePoint Server

El método usado para restaurar paquetes de solución depende de si las personalizaciones se implementan como soluciones de confianza o soluciones de espacio aislado.

Las soluciones de confianza son soluciones que implementan los administradores de granjas de servidores. Se implementan en toda la granja de servidores y se pueden usar en cualquier sitio de esta. Las soluciones de confianza se almacenan en la base de datos de configuración. Cuando se realiza una copia de seguridad de la granja de servidores con la copia de seguridad SharePoint Server, también se realiza una copia de seguridad de las soluciones de confianza y estas se incluyen en las copias de seguridad de solo configuración. También se puede realizar una copia de seguridad de estas como un grupo o individualmente, y son visibles en la jerarquía de restauración.

Las soluciones de espacio aislado son soluciones que los administradores de la colección de sitios pueden implementar en una sola colección de sitios. Las soluciones de espacio aislado se almacenan en la base de datos de contenido asociada a la colección de sitios en la que se implementan. Se incluyen en la granja de servidores de SharePoint Server, la aplicación web, la base de datos de contenido y las copias de seguridad de colecciones de sitios, pero no están visibles en la jerarquía de restauración y no se pueden seleccionar ni restaurar individualmente.

Para restaurar una solución de confianza con Administración central

Compruebe si la cuenta de usuario que lleva a cabo este procedimiento pertenece al grupo de administradores de la granja de servidores de SharePoint.
Inicie Administración central.
En Administración central, en la sección Copias de seguridad y restauración de la página principal, haga clic en Restaurar a partir de copia de seguridad.
En la página Restaurar a partir de copia de seguridad — Paso 1 de 3: Seleccionar la copia de seguridad que se desea restaurar, en la lista de copias de seguridad, seleccione el trabajo de copia de seguridad que contiene el paquete de solución y, a continuación, haga clic en Siguiente. Puede ver más detalles acerca de cada copia de seguridad si hace clic en el símbolo (+) que se encuentra junto a la copia de seguridad.

Nota:

Si no aparece la tarea de copia de seguridad correcta, en el cuadro de texto Ubicación del directorio de copia de seguridad escriba la ruta de acceso UNC (convención de nomenclatura universal) de la carpeta correcta de la copia y haga clic en Actualizar.
En la página Restaurar a partir de copia de seguridad - Paso 2 de 3: Seleccionar componente para restaurar, active la casilla situada junto a la solución y haga clic en Siguiente.
En la página Restaurar a partir de copia de seguridad - Paso 3 de 3: Seleccione la página Opciones de restauración. En la sección Restaurar componente, asegúrese de que Solución aparece en la lista Restaurar el siguiente componente.

En la sección Restaurar solo las opciones de configuración, asegúrese de que la opción Restaurar el contenido y las opciones de configuración está seleccionada.

En la sección Opciones de restauración, en Tipo de restauración, seleccione la opción Misma configuración. Aparece un cuadro de diálogo que le pide que confirme la operación. Haga clic en Aceptar.

Haga clic en Iniciar restauración.
Puede ver el estado general de todos los trabajos de recuperación en la parte superior de la página Estado del trabajo de copia de seguridad y restauración en la sección Disponibilidad. Puede ver el estado del trabajo de recuperación actual en la parte inferior de la página en la sección Restaurar. La página de estado se actualiza automáticamente cada 30 segundos. Para actualizar los detalles de estado manualmente, haga clic en Actualizar. La copia de seguridad y la recuperación son trabajos del servicio del temporizador. Por lo tanto, la copia de seguridad puede tardar unos segundos en iniciarse.

Si recibe mensajes de error, puede revisarlos en la columna Mensaje de error de la página Estado del trabajo de copia de seguridad y restauración. También puede encontrar más detalles en el archivo Sprestore.log en la ruta de acceso UNC que especificó en el paso 3.

Para restaurar una solución de confianza con PowerShell

Compruebe que cumple con las pertenencias siguientes:
- Rol fijo de servidor securityadmin en la instancia de SQL Server.
- Rol fijo de base de datos db_owner en todas las bases de datos que se van a cargar.
- Grupo de servidores en el servidor en el que se van a ejecutar los cmdlets de PowerShell.
  
  Un administrador puede usar el cmdlet Add-SPShellAdmin para conceder permisos de uso para los cmdlets de SharePoint Server.
Nota:

Si no dispone de permisos, póngase en contacto con el administrador para la instalación o con el administrador de SQL Server para solicitarlos. Para más información sobre permisos de PowerShell, vea Add-SPShellAdmin.
Inicie el Shell de administración de SharePoint.
En el símbolo del sistema de PowerShell, escriba el comando siguiente:
```
Restore-SPFarm -Directory <BackupFolder> -RestoreMethod Overwrite -BackupId <GUID> -Item <SolutionPath>
```
Donde:
- <BackupFolder> es la ubicación de UNC del directorio desde el que desea restaurar.
- <GUID> es el GUID del identificador de copia de seguridad desde el que desea restaurar. Si no especifica una copia de seguridad, se usará la más reciente.
- <SolutionPath> es la ruta de acceso de la solución dentro del árbol de copia de seguridad (normalmente farm\solutions\ SolutionName).

Para obtener más información, vea Restore-SPFarm.

Nota:

Se recomienda usar Windows PowerShell para realizar tareas administrativas de línea de comandos. La herramienta de línea de comandos Stsadm ya no se usa, pero se ha incluido para ofrecer compatibilidad con las versiones anteriores del producto.

Restauración de una solución de espacio aislado

No puede restaurar solo las personalizaciones que se implementaron como soluciones de espacio aislado. En su lugar, debe restaurar la granja de servidores, aplicación web, base de datos de contenido o colección de sitios a la que esté asociada la personalización.

Restaurar elementos de sitio creados en SharePoint Server

No puede restaurar únicamente los elementos de sitio creados. En su lugar, debe restaurar la granja de servidores, aplicación web o base de datos de contenido a la que esté asociado el elemento de sitio creado.

Restaurar flujos de trabajo en SharePoint Server

Los flujos de trabajo son un caso especial de personalización, ya que puede restaurarlos. Asegúrese de que el plan de copia de seguridad y recuperación incluya uno de los siguientes escenarios que se aplican al entorno:

Los flujos de trabajo declarativos, como los creados en SharePoint Designer, se almacenan en la base de datos de contenido de la colección de sitios en la que se implementan. Restaure la base de datos de contenido o la colección de sitios para restaurar estos flujos de trabajo.
Las acciones personalizadas de flujos de trabajo declarativos tienen componentes en las tres ubicaciones siguientes:
- Los ensamblados de Visual Studio 2013 para las acciones se almacenan en la memoria caché global de ensamblados (GAC).
- Los archivos de definición XML (archivos .actions) se almacenan en el directorio 16\TEMPLATE<LCID>\Workflow.
- Una entrada XML para marcar la acción como un tipo autorizado se almacena en el archivo Web.config de las aplicaciones web en las que se usa.
  
  Si los flujos de trabajo de la granja de servidores usan acciones personalizadas, debe usar un sistema de restauración de archivos para restaurar estos archivos y entradas XML. Puede volver a aplicar los archivos según sea necesario después de la recuperación.
Los flujos de trabajo que dependen de código personalizado, como los creados mediante Visual Studio 2013, se almacenan en dos ubicaciones. Los ensamblados de Visual Studio 2013 para el flujo de trabajo se almacenan en la GAC y los archivos de definición XML se almacenan en el directorio Características. Esto es lo mismo que otros tipos de características de SharePoint Server, como elementos web y receptores de eventos. Si el flujo de trabajo se ha instalado como parte de un paquete de solución, siga las instrucciones para restaurar paquetes de solución.
Si crea un flujo de trabajo personalizado que interactúa con una colección de sitios distinta de aquella en la que se implementa el flujo de trabajo, debe restaurar ambas colecciones de sitios para recuperar el flujo de trabajo. La restauración de la granja de servidores es suficiente para recuperar todas las colecciones de sitios de la granja de servidores y todos los flujos de trabajo que están asociados a ellas.
Los flujos de trabajo que no se han implementado se deben restaurar por separado mediante una aplicación de copia de seguridad del sistema de archivos.

Restauración de cambios en el archivo Web.config en SharePoint Server

Puede recuperar los cambios en el archivo Web.config realizados con Administración central o el modelo de objetos y las APISharePoint Server realizando una recuperación de la granja de servidores o de solo configuración.

Debe usar una copia de seguridad del sistema de archivos para proteger los cambios en el archivo Web.config que no se realizan mediante Administración central o las API y el modelo de objetos de SharePoint. Puede recuperar la copia de seguridad mediante la restauración del sistema de archivos.

Restaurar personalizaciones desarrolladas que no están empaquetadas como soluciones en SharePoint Server

La restauración de personalizaciones desarrolladas que no están empaquetadas como soluciones puede ser un proceso complejo, ya que las ubicaciones de los archivos de personalización no están normalizadas.

Consulte al proveedor de personalización o al equipo de desarrollo para determinar si las personalizaciones requieren software complementario adicional o archivos en otras ubicaciones. Se recomienda restaurar directorios con una solución de restauración de sistemas de archivos. En la siguiente tabla se enumeran las ubicaciones en los servidores web donde normalmente se almacenan las personalizaciones.

Ubicación	Descripción
%PROGRAMFILES%\Common files\Microsoft Shared\Web Server Extensions\16	Archivos actualizados comúnmente, ensamblados personalizados, plantillas personalizadas y definiciones de sitio personalizadas.
Inetpub	Ubicación de directorios virtuales de IIS
%WINDIR%\Assembly	Caché global de ensamblados (GAC): ubicación protegida del sistema operativo en la que se instalan los ensamblados de código de Microsoft .NET Framework para proporcionar acceso total al sistema.