RenameDT, commande

Article
08/22/2008

Mise à jour : novembre 2007

Utilisez RenameDT pour modifier le nom du serveur de couche Données de Team Foundation Server.

Remarque importante :
Pour que la commande RenameDT s'exécute avec succès, les pools d'applications et les programmes suivants doivent être en cours d'exécution.

Pool d'applications Team Foundation Server (pool d'applications)
ReportServer (pool d'applications)

Remarque :

Vous gérez le pool d'applications ReportServer dans IIS (Internet Information Services) pour SQL Server 2005 mais pas pour SQL Server 2008.
SQL Server Reporting Services (programme)

Remarque :
Vous gérez le pool d'applications ReportServer dans IIS (Internet Information Services) pour SQL Server 2005 mais pas pour SQL Server 2008.

Autorisations requises

Pour utiliser la commande RenameDT, vous devez être membre du groupe Team Foundation Administrators sur le serveur de couche Application de Team Foundation et membre du groupe sysadmin dans SQL Server sur le serveur de couche Données de Team Foundation. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Remarque :
Même si vous êtes connecté en tant qu'administrateur, vous devez ouvrir une invite de commandes avec les autorisations élevées pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une invite de commandes avec les autorisations élevées, 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 le site Web Microsoft (page pouvant être en anglais).

Même si vous êtes connecté en tant qu'administrateur, vous devez ouvrir une invite de commandes avec les autorisations élevées pour exécuter cette fonction sur un serveur Windows Server 2008. Pour ouvrir une invite de commandes avec les autorisations élevées, 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 le site Web Microsoft (page pouvant être en anglais).

TFSAdminUtil RenameDT servername

Paramètres

Argument	Description
servername	Spécifie le nom de l'ordinateur de couche Données cible. L'ordinateur peut être identifié selon les types suivants : Adresse IP L'adresse IP doit être sous le format : aaa.bbb.ccc.ddd. Nom de l'ordinateur Aucun espace ou caractère spécial, tel que ";: <> *, seuls les caractères (A-Z \| 0-9 \| -) sont autorisés, ne peut pas se composer entièrement de nombres, 15 caractères maximum pour des caractères ASCII normaux et 7 caractères maximum pour des caractères de plus grand codage. Pour plus d'informations, consultez Restrictions de dénomination pour Team Foundation Server. Adresse de domaine Par exemple, Myserver.location.mycompanyt.com.

servername

Spécifie le nom de l'ordinateur de couche Données cible. L'ordinateur peut être identifié selon les types suivants :

Adresse IP

L'adresse IP doit être sous le format : aaa.bbb.ccc.ddd.
Nom de l'ordinateur

Aucun espace ou caractère spécial, tel que ";: <> *, seuls les caractères (A-Z | 0-9 | -) sont autorisés, ne peut pas se composer entièrement de nombres, 15 caractères maximum pour des caractères ASCII normaux et 7 caractères maximum pour des caractères de plus grand codage. Pour plus d'informations, consultez Restrictions de dénomination pour Team Foundation Server.
Adresse de domaine

Par exemple, Myserver.location.mycompanyt.com.

Notes

Remarque importante :
Nous vous recommandons de sauvegarder les bases de données sur le serveur de couche Données de Team Foundation Server.

Les chaînes TFSNameUrl et TFS Name dans le fichier Web.config des services, qui se trouve dans Lecteur:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services sur la couche de données, doivent faire référence au serveur de couche Données actuel de Team Foundation Server. Si ce n'est pas le cas, la commande RenameDT échoue silencieusement.

La couche Application de Team Foundation Server doit savoir l'adresse ou le nom exact du serveur de couche Données pour l'atteindre. Le nom et l'adresse de couche Données sont stockés dans de nombreux emplacements dans Team Foundation Server, à la fois dans la couche Application et les bases de données de couche Données. Lorsqu'il est nécessaire de basculer vers une nouvelle couche Données, l'administrateur doit vérifier que Team Foundation Server pointe vers les nouveaux nom et adresse de couche Données.

La commande RenameDT de l'utilitaire en ligne de commande TFSAdminUtil automatise le processus de changement de nom de couche Données en mettant à jour Team Foundation Server pour qu'il pointe vers un nouveau nom ou une nouvelle adresse. La commande RenameDT peut également permettre d'automatiser ou de planifier le processus d'attribution d'un nouveau nom à la couche Données.

La commande RenameDT peut être exécutée uniquement sur la couche Application, car elle recherche le fichier web.config sur l'ordinateur sur lequel elle est exécutée. Elle ne possède pas de fonction d'accès distant et ne prend aucun autre paramètre pour spécifier l'ordinateur de couche Application cible.

Scénarios d'exemple d'usage

La commande RenameDT peut être utilisée par l'administrateur dans différents scénarios. Les scénarios d'exemple sont répertoriés dans la liste suivante :

L'administrateur doit exécuter une maintenance de routine sur la couche Données et doit prendre la couche Données hors connexion en la remplaçant par une autre couche Données temporaire pour éviter d'être indisponible.
L'administrateur exécute la commande RenameDT de l'utilitaire en ligne de commande TFSAdminUtil de sorte que Team Foundation Server se connecte désormais à la nouvelle couche Données temporaire. Lorsque la maintenance est terminée, l'administrateur exécute encore l'utilitaire pour basculer vers une couche Données antérieure.
La couche Données a échoué et n'est pas fonctionnelle.
L'administrateur exécute la commande RenameDT pour que Team Foundation Server pointe vers un nouveau serveur de sauvegarde.
La couche Données est mise à niveau à un nouveau serveur.
L'administrateur exécute la commande RenameDT pour que Team Foundation Server pointe vers le nouveau serveur de couche Données.
De nouvelles stratégies d'opérations déclarent des normes d'affectation de nom à l'ordinateur spécifique que la couche Données doit respecter.
L'administrateur utilise la commande RenameDT pour attribuer à la couche Données un nom plus approprié.
L'organisation ou l'entreprise s'est développée et doit effectuer une migration d'une solution à un serveur vers une solution à deux serveurs.
Une fois que la nouvelle couche Données indépendante est paramétrée, l'administrateur exécute la commande RenameDT pour que Team Foundation Server pointe vers le nouveau serveur.