Restore-SPSite

Referência

Módulo:: SharePointServer

Aplica-se a:: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Restaura um conjunto de sites.

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 contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

O Restore-SPSite cmdlet executa uma restauração do conjunto de sites em um local especificado pelo parâmetro Identity. Um banco de dados de conteúdo só pode conter uma cópia de um conjunto de sites. Se for executado o backup de um conjunto de sites e se ele for restaurado para um local de URL diferente do mesmo aplicativo Web, um banco de dados de conteúdo adicional deverá estar disponível para armazenar a cópia restaurada do conjunto de sites.

Exemplos

--------------------EXEMPLO 1-----------------------

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

Este exemplo restaura uma coleção de sites do arquivo de backup C:\Backup\site_name.bak para a URL da coleção de sites https://server_name/sites/site_name.

----------------------EXEMPLO 2----------------------

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

Este exemplo restaura um backup de coleção de sites do arquivo de backup C:\Backup\site_name.bak, mas substitui a coleção https://server_name/sites/site_name de sites existente ao especificar que a coleção de sites deve ser armazenada em um banco de dados de conteúdo específico.

----------------------EXEMPLO 3----------------------

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

Este exemplo restaura um backup da coleção de sites do arquivo de backup \\file_server\share\site_name.bak para a coleção https://www.example.com de sites nomeada pelo host no aplicativo Web https://server_name.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória 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

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte 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 o banco de dados de conteúdo do SQL Server em que os dados do conjunto de sites serão armazenados. Se nenhum banco de dados de conteúdo for especificado, será usado o banco de dados de conteúdo com a maior capacidade não utilizada de conjunto de sites e cujo status seja pronto.

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 o banco de dados de conteúdo do SQL Server em que os dados do conjunto de sites serão armazenados. Se nenhum banco de dados de conteúdo for especificado, o banco de dados de conteúdo com a maior capacidade de conjunto de sites não utilizados e cujo status de banco de dados seja pronto será usado.

O tipo deve ser um nome de banco de dados válido, no formato SQLDB1.

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 o nome do SQL Server que contém o banco de dados de conteúdo especificado no parâmetro DatabaseName.

O tipo deve ser um nome de servidor de banco de dados válido, na forma SQLBE1 e precisa ser usado em conjunto com o 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 o conjunto de sites existente no local da URL a ser substituído por esta restauraçã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

-GradualDelete

Especifica que a coleção de sites que está sendo substituída com o parâmetro Force deve ser gradualmente excluída ao longo do tempo por um trabalho de temporizador em vez de tudo de uma vez, o que reduz seu impacto sobre produtos do SharePoint e SQL Server desempenho. Essa opção é recomendada para conjuntos de sites grandes.

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

Uma URL válida atribuída ao aplicativo Web usando mapeamento de acesso alternativo, como https://server_name

Restaura um conjunto de sites como um conjunto de sites com nome de host em vez de baseado em caminho. Quando o parâmetro HostHeaderWebApplication está presente, o valor do parâmetro Identity é a URL do conjunto de sites com nome de host e o valor do parâmetro HostHeaderWebApplication é a URL de um aplicativo Web que hospedará o conjunto de sites com nome 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 o local da URL para o qual o conjunto de sites será restaurado.

O conjunto de sites não precisa existir no local da URL para que uma restauração seja executada. No entanto, você precisa especificar um local de URL válido para que um conjunto de sites possa ser criado. Se um conjunto de sites já existir na URL especificada, será preciso especificar o parâmetro Force para substituí-lo.

O tipo deve ser uma URL válida, no formulário 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 um caminho válido para o local do backup. Por exemplo, C:\Backup\nome_do_site.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

Preserva a ID do Site original em vez de criar uma nova.

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

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte 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

Compartilhar via