Restore-SPSite

Referência

Módulo:: sharepoint-server

Aplica-se a:: SharePoint Server Subscription Edition

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 conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para saber mais sobre como usar conjuntos de parâmetros, confira o artigo Conjuntos de parâmetros de cmdlet.

O Restore-SPSite cmdlet executa uma restauração do conjunto de sites para 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 um conjunto de sites do arquivo de backup C:\Backup\site_name.bak para a URL do conjunto de https://server_name/sites/site_name sites.

----------------------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 conjunto de sites do arquivo de backup C:\Backup\site_name.bak, mas substitui o conjunto de sites existente ao especificar que o conjunto de sites deve ser armazenado em um banco de dados de conteúdo https://server_name/sites/site_name 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 de conjunto de sites do arquivo de backup \ \ file_server\share\site_name.bak para o conjunto de sites nomeado pelo host no https://www.example.com aplicativo Web https://server_name .

Parâmetros

-AssignmentCollection

Gerencia objetos para fins de descarte adequado. 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. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.

Type:	SPAssignmentCollection
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Confirm

Solicita a sua confirmação antes de executar o comando. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-DatabaseName

Especifica o banco de dados de conteúdo do SQL Server onde 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
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Força

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
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-GradualDelete

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-Identidade

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 formato https://server_name/sites/site_name.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-PreserveSiteID

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

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-WhatIf

Exibe uma mensagem que descreve o efeito do comando em vez de executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition