Restore-SPSite

Referencia

Módulo:: SharePointServer

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

Restaura una colección de sitios.

Syntax

Restore-SPSite
       [-Identity] <String>
       -Path <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-ContentDatabase <SPContentDatabasePipeBind>]
       [-Force]
       [-GradualDelete]
       [-HostHeaderWebApplication <String>]
       [-WhatIf]
       [-PreserveSiteID]
       [<CommonParameters>]

Restore-SPSite
       [-Identity] <String>
       -Path <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-DatabaseName <String>]
       [-DatabaseServer <String>]
       [-Force]
       [-GradualDelete]
       [-HostHeaderWebApplication <String>]
       [-WhatIf]
       [-PreserveSiteID]
       [<CommonParameters>]

Description

Este cmdlet contiene más de un conjunto de parámetros. Solo puede usar parámetros de un conjunto y no puede combinar parámetros de conjuntos distintos. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.

El Restore-SPSite cmdlet realiza una restauración de la colección de sitios en una ubicación especificada por el parámetro Identity. Una base de datos de contenido únicamente puede contener una copia de una colección de sitios. Si se realiza una copia de seguridad de una colección de sitios y, a continuación, se restaura a una ubicación URL distinta en la misma aplicación web, es necesario que haya una base de datos de contenido adicional disponible para almacenar la copia restaurada de la colección de sitios.

Ejemplos

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

Restore-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak

En este ejemplo se restaura una colección de sitios desde el archivo de copia de seguridad C:\Backup\site_name.bak a la dirección URL de la colección de sitios. https://server_name/sites/site_name.

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

Restore-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak -Force -DatabaseServer SQLBE1 -DatabaseName SQLDB1

En este ejemplo se restaura una copia de seguridad de la colección de sitios desde el archivo de copia de seguridad C:\Backup\site_name.bak, pero se sobrescribe la colección de sitios existente en al https://server_name/sites/site_name tiempo que se especifica que la colección de sitios debe almacenarse en una base de datos de contenido específica.

----------------------EJEMPLO 3----------------------

Restore-SPSite https://www.example.com -Path \\file_server\share\site_name.bak -HostHeaderWebApplication https://server_name

En este ejemplo se restaura una copia de seguridad de la colección de sitios desde el archivo de copia de seguridad \\file_server\share\site_name.bak a la colección https://www.example.com de sitios con nombre de host en la aplicación web. https://server_name.

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

-ContentDatabase

Especifica la base de datos de contenido de SQL Server en la que almacenará los datos de la colección de sitios. Si no especifica ninguna base de datos de contenido, se usará aquella que esté preparada y disponga de mayor capacidad de colección de sitios sin usar.

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

-DatabaseName

Especifica la base de datos de contenido de SQL Server en la que almacenará los datos de la colección de sitios. Si no se especifica ninguna base de datos de contenido, se usará la base de datos de contenido con una mayor capacidad para la colección de sitios sin usar y cuyo estado de base de datos esté listo.

El tipo debe ser un nombre de base de datos válido, con el formato DBSQL1.

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

-DatabaseServer

Especifica el nombre de SQL Server que contiene la base de datos de contenido que especifica el parámetro DatabaseName.

El tipo debe ser un nombre de servidor de base de datos válido, con el formato SQLBE1, y debe usarse en conjunto con el parámetro DatabaseName.

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

-Force

Especifica que se sobrescribirá la colección de sitios existente en la ubicación URL al realizar la restauración.

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

-GradualDelete

Especifica que la colección de sitios que se sobrescribe con el parámetro Force debe eliminarse gradualmente con el tiempo mediante un trabajo de temporizador en lugar de todo a la vez, lo que reduce su impacto en los productos de SharePoint y SQL Server rendimiento. Esta opción es la recomendada para colecciones de sitios de gran tamaño.

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

-HostHeaderWebApplication

Una dirección URL válida asignada a la aplicación web mediante la asignación de acceso alternativa, como https://server_name

Restaura una colección de sitios como una colección de sitios con nombre de host, en lugar de una colección de sitios basada en la ruta de acceso. Cuando se usa el parámetro HostHeaderWebApplication, el valor del parámetro Identity es la dirección URL de la colección de sitios con nombre de host y el valor del parámetro HostHeaderWebApplication es la dirección URL de la aplicación web que va a hospedar la colección de sitios con nombre de host.

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

-Identity

Especifica la ubicación URL en la que la colección de sitios se va a restaurar.

No es necesario que una colección de sitios exista ya en la ubicación URL para realizar una restauración. Sin embargo, debe especificar una ubicación URL válida en donde se pueda crear una colección de sitios. Si ya existe una colección de sitios en la ubicación URL especificada, debe especificar el parámetro Force para sobrescribirla.

El tipo debe ser una dirección URL válida, en el formulario https://server_name/sites/site_name.

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

-Path

Especifica una ruta de acceso válida a la ubicación de la copia de seguridad. Por ejemplo, C:\Copia de seguridad\nombre_de_sitio.bak.

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

-PreserveSiteID

Conserva el identificador de sitio original en lugar de crear uno nuevo.

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