Share via


Connect-SPConfigurationDatabase

Connette il computer server locale a una farm.

Sintassi

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

Descrizione

Il cmdlet Connect-SPConfigurationDatabase connette il server corrente al database di configurazione specificato.

Fondamentalmente questo cmdlet connette il server alla farm. Se il computer corrente non può essere connesso a una farm, viene visualizzato un messaggio di errore simile al seguente:

"Computer già connesso a una farm di SharePoint. Vedere: Dismount-SPConfigurationDatabase"

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO------------------

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

Questo esempio consente di aggiungere il computer server locale a una farm configurata per l'utilizzo del database SharePointConfigurationDatabase in un'istanza di SQL Server utilizzando il nome ServerName\InstanceName con la passphrase MyP@ssw0rd.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

Specifica l'oggetto PSCredential contenente il nome utente e la password da utilizzare per l'autenticazione di SQL Server del database. Se non si specifica questo parametro, verranno utilizzate le credenziali dell'utente corrente.

Il tipo deve essere un oggetto PSCredential valido.

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

Specifica il partner mirroring del database per un'istanza di 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

Specifica il nome del database di configurazione a cui connettere il server.

Il tipo deve essere un nome di database valido, ad esempio 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

Specifica il server in cui creare il database di configurazione. Il valore predefinito è il nome del computer locale.

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

Specifica l'oggetto MinRole assegnato al server locale.

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

Specifica la passphrase sicura per la connessione del server corrente al database di configurazione.

Il tipo deve essere una stringa sicura valida, ad esempio ChiaveServerAppBDC1.

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

Per impostazione predefinita, tutti i server della farm vengono registrati come host della cache, ovvero per impostazione predefinita viene eseguito il servizio DistributedCacheService.

Utilizzare questo parametro per non registrare il computer server come host della cache distribuita. Se si desidera disporre di un host della cache dedicata, utilizzare questo parametro per assicurarsi che il servizio di memorizzazione nella cache non venga installato nel computer.

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