Backup-SPFarm

Cria um backup de um banco de dados individual, aplicativo da Web ou todo o farm.

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 -ShowTree conjunto de 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 -ConfigurationOnly

Este exemplo faz backup das configurações do farm para o \ \ diretório file_server\compartilhamento\Backup.

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

Backup-SPFarm -ShowTree -Item "Microsoft SharePoint Foundation Web Application" -Verbose

Este 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 -Force

Este 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 -ShowTree

Este exemplo mostra os objetos disponíveis para fazer backup com Backup-SPFarm .

Parâmetros

-AssignmentCollection

Gerencia objetos para fins de descarte adequado. 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
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
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
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.

SharePoint pode sobrestimar a quantidade de espaço necessária para um backup somente de configuração SharePoint, o que pode resultar em uma estimativa de que ele não tem espaço suficiente para armazenar o backup no caminho especificado. Use o parâmetro nesta situação para prosseguir com o backup se você tiver espaço suficiente -Force para armazenar o backup somente de configuração.

Type:SwitchParameter
Position:Named
Default value:None
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
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 onde SharePoint Products armazena o pacote de backup gerado. Se você tiver um computador no qual SQL Server e uma instância de produtos SharePoint estão instalados, você poderá usar caminhos de unidade locais. Isso inclui uma instalação básica. No entanto, se os produtos SQL Server e SharePoint estão instalados em vários computadores ou se você tiver vários servidores executando produtos do SharePoint, você deverá usar caminhos de compartilhamento unc (Convenção de Nomenização Universal) para que o banco de dados do 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
  • \\nome_do_servidor\nome_da_pasta

As pastas spbr* são criadas automaticamente.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
-Força

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
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 SharePoint Foundation Web Application\SharePoint - 80.

Type:String
Position:Named
Default value:None
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. As atualizações de progresso reais podem ser maiores do que o solicitado. As atualizações de progresso são sempre gravadas 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
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 ser respaldados serão incluídos entre colchetes ( [ ] ). O backup não será realizado se o parâmetro ShowTree estiver presente.

Type:SwitchParameter
Position:Named
Default value:None
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 executá-lo. Para obter mais informações, digite o seguinte comando: get-help about_commonparameters

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