Compartilhar via

Restore-SPSite

Módulo:
SharePointServer module

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 efetua um restauro da coleção de sites para uma localização especificada 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 a partir do ficheiro de cópia de segurança C:\Backup\site_name.bak para o 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 uma cópia de segurança de uma coleção de sites a partir do ficheiro de cópia de segurança C:\Backup\site_name.bak, mas substitui a coleção de sites existente ao https://server_name/sites/site_name especificar que a coleção de sites tem de ser armazenada numa base de dados de conteúdos específica.

EXEMPLO 3

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

Este exemplo restaura uma cópia de segurança da coleção de sites a partir do ficheiro de cópia de segurança \\file_server\share\site_name.bak para a coleção de sites com nome de anfitrião https://www.example.com na aplicação 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 a coleção de sites que está a ser substituída com o parâmetro Force deve ser gradualmente eliminada ao longo do tempo por uma tarefa de temporizador em vez de todas ao mesmo tempo, o que reduz o impacto nos Produtos SharePoint e SQL Server desempenho. 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

Um URL válido atribuído à aplicação Web através do 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 tem de ser um URL válido, no formulário 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 o ID do Site original em vez de criar um novo.

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 suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.