Backup-SPConfigurationDatabase

Executa somente o backup de configurações no nível do farm.

Syntax

Backup-SPConfigurationDatabase
      -Directory <String>
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [<CommonParameters>]
Backup-SPConfigurationDatabase
      [-AssignmentCollection <SPAssignmentCollection>]
      [-DatabaseCredentials <PSCredential>]
      [-DatabaseName <String>]
      [-DatabaseServer <String>]
      [-Item <String>]
      [-ShowTree]
      [<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-SPConfigurationDatabase executa um backup somente de configurações do farm atual ou um backup somente de configurações de um banco de dados de configuração separado. Para executar um backup somente das configurações do farm atual, não é necessário especificar os parâmetros DatabaseServer e DatabaseName. No entanto, usar o cmdlet Backup-SPFarm com o parâmetro ConfigurationOnly é recomendado para esse cenário.

Por exemplo, um administrador cria um modelo de configuração de farm que pode ser aplicado a outros farms do SharePoint executando uma restauração por meio do cmdlet Restore-SPFarm.

Para obter permissões e as informações mais atuais sobre Windows PowerShell para Produtos do SharePoint, consulte a documentação online em https://go.microsoft.com/fwlink/p/?LinkId=251831.

Exemplos

-------------------EXEMPLO 1--------------------

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -ShowTree

Este exemplo exibe os componentes disponíveis para inclusão em um backup somente de configurações.

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

Backup-SPConfigurationDatabase -DatabaseName SharePoint_Config -DatabaseServer SqlServer1 -Directory \\server\share\Backup -Verbose

Este exemplo executa um backup somente de configurações com uma saída detalhada.

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

-DatabaseCredentials

Especifica a ID e a senha que correspondem ao nome de usuário do administrador do banco de dados do SQL Server.

Esse parâmetro só deve ser especificado se a autenticação do SQL for utilizada para a conexão com o banco de dados. Se a autenticação do Windows for utilizada para a conexão com o banco de dados, esse parâmetro não deve ser especificado.

Type:PSCredential
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

-DatabaseName

Especifica o nome do banco de dados de configuração.

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

-DatabaseServer

Especifica o servidor de banco de dados SQL que contém o banco de dados de configuração. O valor padrão é o nome do computador local.

O tipo deve ser um servidor de banco de dados válido; por exemplo, DS.

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

-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

-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. Caso vários itens tenham o mesmo nome, o caminho completo deverá ser fornecido. Coloque o item ou o caminho entre aspas, se ele contiver um espaço.

Se o parâmetro Item não for especificado, toda a configuração do farm será incluída no backup.

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

-ShowTree

Exibe os objetos no farm que sofrerão backup com base nos outros parâmetros passados para o cmdlet de backup, 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-SPConfigurationDatabase 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