Restore-SPSite
Restaura um conjunto de sites.
Sintaxe
DatabaseFromPipebind
Restore-SPSite
[-Identity] <String>
-Path <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-ContentDatabase <SPContentDatabasePipeBind>]
[-Force]
[-GradualDelete]
[-HostHeaderWebApplication <String>]
[-WhatIf]
[-PreserveSiteID]
[<CommonParameters>]
DatabaseParameter
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 um conjunto de sites do arquivo de backup C:\Backup\site_name.bak para a URL do conjunto 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 conjunto de sites do arquivo de backup C:\Backup\site_name.bak, mas substitui o conjunto https://server_name/sites/site_name de sites existente ao especificar que o conjunto de sites deve ser armazenado 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 de conjunto de sites do arquivo de backup \\file_server\share\site_name.bak para o conjunto https://www.example.com de sites com nome de host no aplicativo Web https://server_name.
Parâmetros
-AssignmentCollection
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SPAssignmentCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ContentDatabase
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SPContentDatabasePipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DatabaseFromPipebind
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DatabaseName
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DatabaseParameter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DatabaseServer
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DatabaseParameter
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o conjunto de sites existente no local da URL a ser substituído por esta restauração.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-GradualDelete
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 nos produtos do SharePoint e no desempenho do SQL Server. Essa opção é recomendada para conjuntos de sites grandes.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-HostHeaderWebApplication
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Path
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica um caminho válido para o local do backup. Por exemplo, C:\Backup\nome_do_site.bak.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PreserveSiteID
Aplicável: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Preserva a ID do site original em vez de criar uma nova.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.