Compartilhar via


Connect-SPConfigurationDatabase

Conecta o computador servidor local a um farm.

Syntax

Connect-SPConfigurationDatabase
       [-DatabaseName] <String>
       [-SkipRegisterAsDistributedCacheHost]
       [-Passphrase] <SecureString>
       -DatabaseServer <String>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-DatabaseCredentials <PSCredential>]
       [-DatabaseFailOverPartner <String>]
       [-LocalServerRole <SPServerRole>]
       [<CommonParameters>]

Description

O cmdlet Connect-SPConfigurationDatabase conecta o servidor atual ao banco de dados de configuração especificado.

Basicamente, esse cmdlet conecta o servidor ao farm. Se o computador atual não puder conectar-se a um farm, a mensagem de erro a seguir será exibida:

"Esta máquina já está conectada a um farm do SharePoint. Consulte: Dismount-SPConfigurationDatabase"

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

Connect-SPConfigurationDatabase -DatabaseServer "ServerName\InstanceName" -DatabaseName "SharePointConfigurationDatabaseName" -Passphrase (ConvertTo-SecureString "MyP@ssw0rd" -AsPlainText -Force)
Start-Service SPTimerv4

Este exemplo associa o computador servidor local a um farm configurado para usar o banco de dados SharePointConfigurationDatabase em uma instância do SQL Server com o nome ServerName\InstanceName e a senha MyP@ssw0rd.

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 o objeto PSCredential que contém o nome de usuário e a senha a serem usados para a autenticação SQL de banco de dados. Caso esse parâmetro não seja especificado, o usuário atual será usado.

O tipo deve ser um objeto PSCredential válido.

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

-DatabaseFailOverPartner

Especifica o parceiro de espelhamento de banco de dados para uma instância de SQL Server.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-DatabaseName

Especifica o nome do banco de dados de configuração ao qual o servidor será conectado.

O tipo deve ser um nome de banco de dados válido, por exemplo DB1.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

Especifica o servidor no qual o banco de dados de configuração será criado. O valor padrão é o nome do computador local.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-LocalServerRole

Especifica o MinRole atribuído ao servidor local.

Type:SPServerRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2016, SharePoint Server 2019

-Passphrase

Especifica a senha para conectar o servidor atual ao banco de dados de configuração.

O tipo deve ser uma cadeia de caracteres de segurança válida, por exemplo MyBDCApp1serverkey.

Type:SecureString
Position:9
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SkipRegisterAsDistributedCacheHost

Por padrão, todos os servidores no farm são registrados como um host de cache (isto é, DistributedCacheService está executando por padrão).

Use este parâmetro para não registrar o computador do servidor como um host de cache distribuído. Se você deseja ter um host de cache dedicado, use este parâmetro para garantir que o serviço de armazenamento em cache não está instalado no computador.

Type:SwitchParameter
Position:10
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