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 |