Connect-SPConfigurationDatabase

  • Référence
Module:
SharePointServer
S’applique à:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Connecte l'ordinateur serveur local à une batterie de serveurs.

Syntax

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

Description

La cmdlet Connect-SPConfigurationDatabase connecte le serveur actuel à la base de données de configuration spécifiée.

Cette cmdlet connecte essentiellement le serveur à la batterie. S'il est impossible de connecter l'ordinateur actuel à une batterie, le message d'erreur suivant est affiché :

« Cet ordinateur est déjà connecté à une batterie de serveurs SharePoint. Voir : Dismount-SPConfigurationDatabase »

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

------------------EXEMPLE------------------

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

Cet exemple montre comment associer l'ordinateur serveur local à une batterie de serveurs configurée pour utiliser la base de données SharePointConfigurationDatabase sur une instance SQL Server en utilisant le nom ServerName\InstanceName avec le mot de passe MyP@ssw0rd.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

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

Spécifie l’objet PSCredential contenant le nom et le mot de passe d’utilisateur à utiliser pour l’authentification SQL de la base de données. Si ce paramètre n'est pas spécifié, l'utilisateur actuel est utilisé.

Le type doit être un objet PSCredential valide.

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

Spécifie le partenaire de mise en miroir de bases de données pour une instance 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

Spécifie le nom de la base de données de configuration à laquelle connecter le serveur.

Le type doit correspondre à un nom de base de données valide, par exemple 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

Spécifie le serveur sur lequel créer la base de données de configuration. La valeur par défaut est le nom de l'ordinateur 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

Spécifie le MinRole attribué au serveur 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

Spécifie la phrase de mot de passe sécurisé pour connecter le serveur actuel à la base de données de configuration.

Le type doit être une chaîne sécurisée valide, par exemple 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

Par défaut tous les serveurs dans la batterie sont inscrits en tant qu'hôtes de cache (c'est-à-dire, que DistributedCacheService est exécuté par défaut).

Utilisez ce paramètre pour ne pas inscrire l'ordinateur serveur en tant qu'hôte de cache distribué. Si vous voulez disposer d'un hôte de cache dédié, utilisez alors ce paramètre pour vous assurer que le service de mise en cache n'est pas installé sur l'ordinateur.

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