Backup-SPFarm

Referência

Módulo:: sharepoint-server

Aplica-se a:: SharePoint Server Subscription Edition

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

Este 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" -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 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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-ConfigurationOnly

Se definido, o backup conterá definições de configuração apenas (nenhum dado) para cada um dos objetos a ser feito backup.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition

-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 Subscription Edition