Backup-SPSite
Executa um backup de um conjunto de sites.
Sintaxe
Default (Padrão)
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.
EXEMPLO 4
Backup-SPSite https://server_name/sites/site_name -Path C:\Backup\site_name.bak -NoSiteLock
Este exemplo cria uma cópia de segurança de uma coleção de sites e impede a colocação do site num modo só de leitura durante a fase de cópia de segurança. Utilize o parâmetro -NoSiteLock ao criar uma cópia de segurança de um site em produção onde é desejável não colocar o site num modo só de leitura enquanto a cópia de segurança é efetuada.
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. 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.
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 |
-Force
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifique para substituir um arquivo de backup existente, se ele já existir.
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 |
-Identity
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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".
Propriedades do parâmetro
| Tipo: | SPSitePipeBind |
| 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 |
-NoSiteLock
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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 |
-Path
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o caminho completo para o arquivo de backup (isto é, 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: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UseABSDocStreamInfo
Aplicável: SharePoint Server 2016, SharePoint Server 2019
Não usar.
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 |
-UseSqlSnapshot
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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.