Backup-SPFarm
Cria um backup de um banco de dados individual, um aplicativo Web ou o farm inteiro.
Sintaxe
DefaultSet
Backup-SPFarm
-BackupMethod <String>
-Directory <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-BackupThreads <Int32>]
[-ConfigurationOnly]
[-Force]
[-Item <String>]
[-Percentage <Int32>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ShowTree
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.
EXEMPLO 4
Backup-SPFarm -ShowTree
Este exemplo mostra os objetos disponíveis para backup com Backup-SPFarm.
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 |
-BackupMethod
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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:
- Inteiro
- Diferencial
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-BackupThreads
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ConfigurationOnly
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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 fazer com que o SharePoint estime que 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 de configuração.
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 |
-Confirm
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Solicita a confirmação antes de executar o cmdlet.
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 |
-Directory
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Especifica o caminho em que o Produtos do SharePoint armazena o pacote de backup gerado. Se você tiver um computador no qual o SQL Server e uma instância de produtos do SharePoint estão instalados, poderá usar caminhos de unidade locais. Isso inclui uma instalação básica. No entanto, se os produtos SQL Server e SharePoint estiverem instalados em vários computadores ou se você tiver vários servidores executando produtos do SharePoint, deverá usar os caminhos de compartilhamento UNC (Convenção de nomenclatura universal) 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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | True |
| 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
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Item
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
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: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Percentage
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | Int32 |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
DefaultSet
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ShowTree
Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
ShowTree
| Cargo: | Named |
| Obrigatório: | True |
| 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 dá suporte aos parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.