Partager via


ChangeServerID, commande

La commande ChangeServerID modifie les GUID associés aux bases de données pour Visual Studio Team Foundation Server (TFS).Les GUID doivent être uniques dans un déploiement de TFS.Si plusieurs bases de données ont le même GUID, votre déploiement peut devenir instable ou inutilisable.Vous pouvez modifier le GUID de la base de données de configuration, les GUID pour toutes les bases de données de collections de projets d'équipe pendant le déploiement, ou les deux.Bien que vous n'utilisiez pas en général cette commande dans les opérations quotidiennes, vous pouvez utiliser cette commande dans les circonstances suivantes :

  • Vous avez restauré votre déploiement sur un nouveau matériel, le déploiement ancien est encore opérationnel, et vous souhaitez utiliser les deux déploiements.Ce scénario est parfois désigné sous le nom de « clonage de serveur ».

  • Vous souhaitez tester une mise à jour de logiciel ou une configuration matérielle sur un déploiement en double pour ne pas risquer d'interrompre votre environnement de production.

  • Vous souhaitez tester intégralement la restauration de bases de données sur un nouveau matériel dans un laboratoire de test ou un environnement séparé, pour vérifier que votre déploiement peut être restauré.

  • Vous devez réinitialiser le GUID pour une base de données de collection après l'avoir déplacé vers un autre déploiement pour lequel ce GUID est déjà réservé.

    [!REMARQUE]

    La commande ChangeServerID n'est pas réversible.Après avoir modifié un GUID, vous ne pouvez pas annuler cette modification sauf en restaurant une version antérieure de cette base de données.

Autorisations requises

Pour utiliser la commande ChangeServerID, vous devez être membre du groupe de sécurité Team Foundation Administrators et du groupe de sécurité sysadmin pour toutes les bases de données SQL Server que Team Foundation Server utilise.Pour plus d'informations, consultez Autorisations de Team Foundation Server.

[!REMARQUE]

Même si vous vous connectez en tant qu'administrateur, vous devez ouvrir une fenêtre d'invite de commandes avec les autorisations élevées pour exécuter cette fonction.

TFSConfig ChangeServerID /SQLInstance:ServerName] /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly] [/usesqlalwayson]

Paramètres

Espace réservé

Description

ServerName

Spécifie le nom du serveur qui héberge la base de données de configuration pour TFS et le nom de l'instance si vous souhaitez utiliser une instance autre que l'instance par défaut.Si vous spécifiez une instance, vous devez utiliser le format suivant :

NomServeur\NomInstance

DatabaseName

Spécifie le nom de la base de données de configuration.Par défaut, le nom de cette base de données est TFS_ConfigurationDB.

Option

Description

/SQLInstance:ServerName

Requis.Spécifie le nom du serveur qui exécute SQL Server et le nom de l'instance si vous souhaitez utiliser une instance autre que l'instance par défaut.Si vous spécifiez une instance, vous devez utiliser le format suivant :

ServerName\InstanceName

/DatabaseName:DatabaseName

Requis.Spécifie le nom de la base de données de configuration pour TFS.

/ProjectCollectionsOnly

Spécifie qu'uniquement les GUID pour les collections seront modifiés.

/ConfigDBOnly

Spécifie qu'uniquement le GUID pour la base de données de configuration sera modifié.

/usesqlalwayson

Spécifie que les bases de données font partie d'un groupe de disponibilité AlwaysOn dans SQL Server.Si elle est configurée, cette option définit MultiSubnetFailover dans la chaîne de connexion.

Pour plus d'informations, consultez Groupes de disponibilité AlwaysOn (SQL Server).

Notes

Vous utilisez la commande ChangeServerID pour créer un doublon discret d'un déploiement de Team Foundation Server pour le test ou le clonage.Une fois que vous avez utilisé la commande ChangeServerID, vous devez demander aux clients de créer une connexion au serveur modifié avant qu'il puisse être utilisé.

Exemple

L'exemple suivant indique comment modifier les GUID de toutes les bases de données dans le déploiement Contoso1 de TFS, où la base de données de configuration est hébergée sur le serveur nommé « ContosoMain » sur l'instance nommée « TeamDatabases » dans SQL Server.

[!REMARQUE]

Ces exemples sont fournis à titre d'illustration uniquement et sont fictifs.Aucune véritable association n'est prévue ou déduite.

TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

Voir aussi

Tâches

Move a Team Project Collection

Split a Team Project Collection

Concepts

Sauvegarde et restauration de votre déploiement

Autres ressources

Gestion de la configuration du serveur avec TFSConfig