Backup-SPFarm
Cria um backup de um banco de dados individual, um aplicativo Web ou o farm inteiro.
Syntax
Backup-SPFarm
-BackupMethod <String>
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-BackupThreads <Int32>]
[-ConfigurationOnly]
[-Force]
[-Item <String>]
[-Percentage <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Backup-SPFarm
[-ShowTree]
[-AssignmentCollection <SPAssignmentCollection>]
[-ConfigurationOnly]
[-Item <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Este cmdlet contém mais de um conjunto de parâmetros. Você só pode usar parâmetros de um único conjunto de parâmetros; além disso, não é possível combinar parâmetros de diferentes conjuntos. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.
O cmdlet Backup-SPFarm cria um backup do farm inteiro ou de componentes individuais dentro do farm. Ele também pode ser usado para fazer backup apenas das definições de configuração de um farm a ser usado como um modelo de farm para outros farms do SharePoint. Se você desejar fazer backup de um único conjunto de sites, use o cmdlet Backup-SPSite.
Para ver os objetos disponíveis para backup, use o conjunto de -ShowTree parâmetros.
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-SPFarm -Directory \\file_server\share\Backup -BackupMethod full -ConfigurationOnlyEste exemplo faz backup das definições de configuração do farm para o diretório \\servidor_de_arquivo\share\Backup.
--------------------EXEMPLO 2---------------------
Backup-SPFarm -ShowTree -Item "Microsoft SharePoint Foundation Web Application" -VerboseEste exemplo mostra que será feito backup dos componentes do farm no nó "Aplicativo Web do Microsoft SharePoint Foundation", mas não executa o backup.
--------------------EXEMPLO 3---------------------
Backup-SPFarm -Directory C:\Backup -BackupMethod full -BackupThreads 10 -ForceEste exemplo executa o backup de um farm usando 10 threads e força o backup a ser salvo no diretório C:\Backup, mesmo que o SharePoint estime que não existe espaço suficiente disponível.
--------------------EXAMPLE 4---------------------
Backup-SPFarm -ShowTreeEste exemplo mostra os objetos disponíveis para fazer backup com Backup-SPFarm.
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 |
-BackupMethod
Especifica o tipo de arquivo de backup a ser criado.
Se um backup for executado com o parâmetro -ShowTree, o parâmetro BackupMethod não será usado.
Um backup completo é um backup de todos os dados selecionados. Um backup diferencial é um backup de todos os dados selecionados que tenham sido alterados desde o último backup completo. Caso um item não dê suporte ao backup diferencial, o backup completo será executado.
O tipo deve ser um dos seguintes:
- Completo
- Diferencial
| 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 |
-BackupThreads
Especifica o número de threads a serem usados durante o backup. Quanto menor o número de threads, mais fácil de ler e compreender o arquivo de log de backup. Quanto mais threads, mais componentes poderão ser incluídos no backup de forma simultânea, potencialmente resultando em uma operação de backup mais rápida. O valor mínimo é 1 e o valor máximo é 10.
O valor padrão é 3.
Se um backup for executado com o parâmetro -ShowTree, o parâmetro BackupMethod não será usado.
| Type: | Int32 |
| 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 |
-ConfigurationOnly
Se definido, o backup conterá definições de configuração apenas (nenhum dado) para cada um dos objetos a ser feito backup.
O SharePoint pode superestimar a quantidade de espaço necessária para um backup somente de configuração, o que pode resultar na estimativa do SharePoint de que ele não tem espaço suficiente para armazenar o backup no caminho especificado. Use o -Force parâmetro nessa situação para prosseguir com o backup se você tiver espaço suficiente para armazenar o backup somente configuraçã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 |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
| 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 |
-Directory
Especifica o caminho em que o SharePoint Products armazena o pacote de backup que ele gera. Se você tiver um computador no qual SQL Server e uma instância de Produtos do SharePoint estiverem instalados, você poderá usar caminhos de unidade locais. Isso inclui uma instalação básica. No entanto, se SQL Server e Produtos do SharePoint estiverem instalados em vários computadores ou se você tiver vários servidores executando produtos do SharePoint, você deverá usar caminhos de compartilhamento da UNC (Convenção Universal de Nomenclatura) para que o banco de dados SQL Server e os componentes de pesquisa sejam gravados no mesmo local; por exemplo, \\computer_name\volume\Backup).
Vários pacotes de backup podem ser armazenados no mesmo local. Esse é o mesmo caminho que você deve transmitir ao parâmetro Directory do cmdlet Restore-SPFarm.
O tipo deve ser qualquer um dos caminhos válidos:
- C:\nome_da_pasta
- \\server_name\folder_name
As pastas spbr* são criadas automaticamente.
| 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 |
-Force
Especifica para continuar com uma operação de backup mesmo se a estimativa for que o diretório de backup não tem espaço suficiente para reter o backup inteiro.
Se um backup for executado com o parâmetro - ShowTree, o parâmetro Force não será usado.
| 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 |
-Item
Indica a parte do farm a ser incluída no backup. Você pode usar a notação de caminho completo do farm, conforme exibido pelo parâmetro ShowTree, ou o nome do componente de destino no caminho, se o componente tiver um nome exclusivo. Se forem incluídos vários itens na mesma correspondência, o caminho completo deverá ser fornecido. Por padrão, o nó superior é selecionado. Coloque o item ou o caminho entre aspas, se ele contiver um espaço. Se esse parâmetro não for especificado, será feito backup do farm inteiro.
O tipo deve ser um item válido; por exemplo, Farm\Microsoft Aplicativo Web do SharePoint Foundation\SharePoint – 80.
| 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 |
-Percentage
Solicita que as atualizações de andamento sobre a operação de backup sejam exibidas em incrementos dessa porcentagem; por exemplo, um valor 5 exibe atualizações do andamento do backup a cada 5% concluídos e um valor 10 exibe atualizações a cada 10% concluídos. Para que as saídas de andamento sejam exibidas, você deve especificar o parâmetro Verbose.
Essa porcentagem não é exata e as atualizações de progresso reais podem ser menores ou maiores do que o solicitado. As atualizações de progresso são sempre registradas no arquivo de log de backup.
O valor de porcentagem não é exato. As atualizações de progresso reais podem ser maiores do que o solicitado.
O valor padrão é 5. Para um banco de dados muito grande, 1 é o valor recomendado.
Os valores válidos são um valor inteiro entre 1 e 100.
| Type: | Int32 |
| 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 |
-ShowTree
Exibe quais objetos no farm sofrerão backup com base nos outros parâmetros passados para o cmdlet Backup-SPFarm, mais especificamente o parâmetro Item. Os itens que serão excluídos do backup com base em outros parâmetros passados para o cmdlet Backup-SPFarm serão precedidos de um asterisco (*). Os itens que não podem sofrer backup ficarão entre colchetes ([ ]). O backup não será realizado se o parâmetro ShowTree estiver presente.
| Type: | SwitchParameter |
| 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 |
-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 |