Connect-SPConfigurationDatabase

Sapplique à :SharePoint Foundation 2013, SharePoint Server 2013 Enterprise

Dernière rubrique modifiée :2015-03-09

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

Connect-SPConfigurationDatabase [-DatabaseName] <String> [-Passphrase] <SecureString> [[-SkipRegisterAsDistributedCacheHost] <SwitchParameter>] -DatabaseServer <String> [-AssignmentCollection <SPAssignmentCollection>] [-DatabaseCredentials <PSCredential>]

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 connaître les autorisations et les informations les plus récentes concernant Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne http://go.microsoft.com/fwlink/p/?LinkId=251831.

Paramètre Obligatoire Type Description

DatabaseName

Requis

System.String

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.

DatabaseServer

Obligatoire

Serveur de base de données valide, tel que « SB ».

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.

Passphrase

Requis

System.Security.SecureString

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.

SkipRegisterAsDistributedCacheHost

Facultatif

System.Management.Automation.SwitchParameter

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.

AssignmentCollection

Facultatif

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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.

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

DatabaseCredentials

Facultatif

System.Management.Automation.PSCredential

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.

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

Afficher: