Restore-SPSite
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.bakEste 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 SQLDB1Este 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_nameEste 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 |