Compartilhar via


Backup-SPConfigurationDatabase

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

Sintaxe

DefaultSet

Backup-SPConfigurationDatabase
    -Directory <String>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-DatabaseCredentials <PSCredential>]
    [-DatabaseName <String>]
    [-DatabaseServer <String>]
    [-Item <String>]
    [<CommonParameters>]

ShowTree

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, a utilização do cmdlet Backup-SPFarm com o parâmetro ConfigurationOnly é recomendada para tal 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 recentes sobre Windows PowerShell para Produtos 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

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

-DatabaseCredentials

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:PSCredential
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:True
Valor dos argumentos restantes:False

-DatabaseName

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

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

-DatabaseServer

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

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

-Directory

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o caminho onde os Produtos SharePoint armazenam o pacote de cópia de segurança que gera. Se tiver um computador no qual estão instalados SQL Server e uma instância de Produtos SharePoint, pode utilizar caminhos de unidade local. Isso inclui uma instalação básica. No entanto, se SQL Server e Produtos SharePoint estiverem instalados em vários computadores ou se tiver vários servidores a executar Produtos SharePoint, tem de utilizar caminhos de partilha UNC (Universal Naming Convention) para que a base de dados SQL Server e os componentes de pesquisa sejam escritos na mesma localização; por exemplo, \\computer_name\volume\Cópia de Segurança).

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

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

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

-ShowTree

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

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

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.