Backup-SPSite

Referência

Módulo:: SharePointServer

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

Executa um backup de um conjunto de sites.

Syntax

Backup-SPSite
      [-Identity] <SPSitePipeBind>
      -Path <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-Confirm]
      [-Force]
      [-NoSiteLock]
      [-UseSqlSnapshot]
      [-WhatIf]
      [-UseABSDocStreamInfo]
      [<CommonParameters>]

Description

O cmdlet Backup-SPSite executa um backup do conjunto de sites quando o parâmetro Identity é usado.

Por padrão, o conjunto de sites será definido como somente leitura durante o backup, a fim de reduzir a possibilidade da atividade do usuário danificar o backup durante a sua operação. Se você tiver o SQL Server Enterprise Edition, será recomendável que o parâmetro UseSqlSnapshot seja usado, porque isso assegura um backup válido e permite que os usuários continuem lendo e gravando no conjunto de sites durante o backup.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

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

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

Este exemplo faz backup de um conjunto de site em https://server_name/sites/site_name no arquivo C:\Backup\nome_do_site.bak.

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

Get-SPSiteAdministration https://server_name/sites/site_name | Backup-SPSite -Path C:\Backup\site_name.bak

Este exemplo faz backup de um conjunto de site em https://server_name/sites/site_name no arquivo C:\Backup\nome_do_site.bak. O mesmo resultado que o Exemplo 1, mas uma maneira diferente de executar a operação.

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

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

Este exemplo faz o backup de um conjunto de sites com instantâneos do banco de dados para assegurar a integridade do backup.

-------------------EXAMPLE 4--------------------

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

Este exemplo faz backup de uma coleção de sites e impede a colocação do site em um modo somente leitura durante a fase de backup. Use o parâmetro -NoSiteLock ao fazer backup de um site em produção em que é desejável não colocar o site em um modo somente leitura enquanto o backup ocorre.

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. 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
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

-Force

Especifique para substituir um arquivo de backup existente, se ele já existir.

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

-Identity

Especifica a URL ou o GUID do conjunto de sites para fazer backup.

Por exemplo, uma URL válida, como https://server_name/sites/site_name, ou um GUID, como "01234567-89ab-cdef-0123-456789abcdef".

Type:	SPSitePipeBind
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

-NoSiteLock

Especifica o conjunto de sites que deverá permanecer como leitura e gravação durante o backup.

Se o parâmetro NoSiteLock não for especificado, um conjunto de sites com a configuração de bloqueio de conjunto de sites "nenhum" ou "sem adições" será temporariamente definido como "somente leitura" durante a execução do backup do conjunto de sites. Depois que o backup for concluído, o bloqueio do conjunto de sites retornará ao seu estado original. O pacote de backup registrará o estado original do bloqueio do conjunto de sites a fim de que ele seja restaurado para esse estado.

Se os usuários estiverem gravando no conjunto de sites durante o seu backup, o parâmetro NoSiteLock não será recomendado para possível impacto à integridade do backup.

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

-Path

Especifica o caminho completo para o arquivo de backup (isto é, C:\Backup\nome_do_site.bak.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-UseABSDocStreamInfo

Não usar.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2016, SharePoint Server 2019

-UseSqlSnapshot

Especifica que um Instantâneo de Banco de Dados SQL será criado quando começar o backup e que todos os dados do conjunto de sites serão recuperados diretamente do instantâneo do banco de dados. Esse instantâneo será automaticamente excluído quando o backup for concluído.

É recomendável usar o parâmetro UseSqlSnapshot caso o servidor de banco de dados que hospeda o banco de dados de conteúdo dê suporte a instantâneos de banco de dados, como o SQL Server Enterprise Edition e o SQL Server Developer Edition. Isto ocorre porque assegurará um backup válido enquanto permite que os usuários continuem lendo e gravando no conjunto de sites durante o backup. Não é necessário determinar o parâmetro NoSiteLock ao especificar o parâmetro UseSqlSnapshot.

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

-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