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
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Comentários
Enviar e exibir comentários de