Connect-SPConfigurationDatabase
Connecte l'ordinateur serveur local à une batterie de serveurs.
Syntaxe
Connect-SPConfigurationDatabase
[-DatabaseName] <String>
[-SkipRegisterAsDistributedCacheHost]
[-Passphrase] <SecureString>
-DatabaseServer <String>
[-AssignmentCollection <SPAssignmentCollection>]
[-DatabaseCredentials <PSCredential>]
[-DatabaseFailOverPartner <String>]
[-LocalServerRole <SPServerRole>]
[-DatabaseConnectionEncryption <SqlConnectionEncryptOption>]
[-DatabaseServerCertificateHostName <String>]
[<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 SPTimerv4Cet 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |
-DatabaseConnectionEncryption
Spécifie si le chiffrement TLS est utilisé pour la connexion entre SharePoint et la base de données. Obligatoire, le chiffrement TLS doit être utilisé. Si le chiffrement TLS ne peut pas être négocié avec succès, la connexion échoue. Facultatif autorise l’utilisation du chiffrement TLS. Si le serveur de base de données requiert le chiffrement TLS, le chiffrement TLS est utilisé. Sinon, le chiffrement TLS ne sera pas utilisé. Strict exige que le chiffrement TLS soit utilisé avec TDS 8.0, qui est la configuration de chiffrement la plus forte. Si le chiffrement TLS avec TDS 8.0 ne peut pas être négocié avec succès, la connexion échoue. Les bases de données montées sur SharePoint avant l’installation de la mise à jour des fonctionnalités de la version 24H2 ont la valeur par défaut chiffrement facultatif. Si ce paramètre n’est pas spécifié lors du montage d’une nouvelle base de données sur SharePoint après l’installation de la mise à jour des fonctionnalités version 24H2, la valeur par défaut est Obligatoire.
| Type: | SqlConnectionEncryptOption |
| Position: | Named |
| Valeur par défaut: | Mandatory |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |
-DatabaseFailOverPartner
Spécifie le partenaire de mise en miroir de bases de données pour un SQL Server instance.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |
-DatabaseServerCertificateHostName
Définit le nom d’hôte à utiliser lors de la validation du certificat de serveur pour la connexion.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |
-LocalServerRole
Spécifie le MinRole attribué au serveur local.
| Type: | SPServerRole |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |
-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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
| S’applique à: | SharePoint Server Subscription Edition |