ChangeServerID, commande
Vous pouvez utiliser la commande ChangeServerID pour modifier les GUID associés aux bases de données pour Visual Studio Team Foundation Server. Les GUID doivent être uniques dans un déploiement de Team Foundation Server. 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é.
Notes
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.
Notes
Même si vous vous connectez en tant qu'administrateur, vous devez ouvrir une fenêtre d'invite de commandes avec des autorisations élevées pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une fenêtre d'invite de commandes avec élévation de privilèges, cliquez sur Démarrer, cliquez avec le bouton droit sur Invite de commandes, puis cliquez sur Exécuter en tant qu'administrateur. Pour plus d'informations, consultez la page du site Web Microsoft : Contrôle de compte d'utilisateur.
TFSConfig ChangeServerID /SQLInstance:ServerName] /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly]
Paramètres
Espace réservé |
Description |
|---|---|
ServerName |
Spécifie le nom du serveur qui héberge la base de données de configuration pour Team Foundation 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 : 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 |
Obligatoire. 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 |
Obligatoire. Spécifie le nom de la base de données de configuration pour Team Foundation Server. |
/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é. |
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 Team Foundation Server, 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.
Notes
Les noms de sociétés, d'organisations, de produits et de domaines, les adresses de messagerie, les logos, et les noms de personnes et de lieux, ou les événements utilisés dans les exemples, sont fictifs. Toute ressemblance avec des noms ou des événements réels est purement fortuite et involontaire.
TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB
Voir aussi
Tâches
Déplacer une collection de projets d'équipe
Fractionner une collection de projets d'équipe
Concepts
Sauvegarde et restauration de votre déploiement