Partager via


Commandes TFSConfig Lab /DNS

La commande TfsConfig Lab /DNS ajoute, supprime ou affiche les enregistrements DNS créés par Visual Studio Lab Management pour les environnements isolés du réseau.

Team Foundation Server utilise le suffixe que vous entrez quand il enregistre un nom externe unique avec DNS pour chaque ordinateur virtuel dans un environnement isolé du réseau. L'enregistrement d'alias DNS permet aux ordinateurs et autres objets en dehors du réseau isolé de communiquer avec des ordinateurs situés dans le réseau isolé. Étant donné que Team Foundation Server entre dans la zone DNS pour enregistrer l'alias, le compte de service sous lequel s'exécute Team Foundation doit avoir les autorisations pour ajouter ou supprimer des enregistrements d'alias dans la zone DNS spécifiée.

Si votre déploiement Team Foundation Server a plusieurs couches Application et que chaque couche Application s'exécute sous un compte de service différent, chaque compte de service de couche Application doit avoir l'autorisation de modifier les enregistrements d'alias DNS créés par les autres couches Application.

Remarque   La gestion des enregistrements DNS est exécutée automatiquement par Lab Management. Vous devez utiliser la commande /DNS uniquement dans les situations suivantes :

  • Vous modifiez le compte sous lequel Visual Studio Team Foundation Server (TFS) s'exécute.

  • Vous déplacez une collection de projets d'équipe d'une instance de Team Foundation Server à l'autre.

Dans ces deux cas, les enregistrements DNS créés à l'aide du compte de service TFS ancien doivent être supprimés, puis, les mêmes enregistrements DNS doivent être recréés à l'aide du nouveau compte de service TFS. Si ces étapes ne sont pas exécutées dans les scénarios précédents, le nouveau compte de service TFS ne sera pas en mesure d'exécuter la gestion automatique de ces enregistrements DNS. Par conséquent, les utilisateurs ne seront pas en mesure de se connecter aux environnements virtuels.

TfsConfig Lab /DNS 
{/Add | /Delete | /List}
    [/CollectionName:collectionName |
    / CollectionName:collectionName /TeamProject:projectName |
    / CollectionName:collectionName /TeamProject:projectName /LabEnvironment:environmentUri |
    /Name:FQDN /IP:IpAddress]
    [/NoPrompt]

Options

Option

Description

Add

Ajoute les enregistrements DNS spécifiés. Pour utiliser l'option /Add, les environnements ciblés doivent s'exécuter.

Delete

Supprime les enregistrements DNS spécifiés.

List

Affiche les enregistrements DNS spécifiés.

LabEnvironment:environmentUri

Cible les options /Add, /Delete ou /List à un environnement isolé du réseau individuel spécifié par environmentUri.

Pour utiliser l'option LabEnvironment, vous devez également spécifier les options /Collection et /TeamProject.

TeamProject:projectName

En cas d'utilisation sans /LabEnvironment, cible les options /Add, /Delete ou /List sur tous les environnements isolés du réseau dans le projet d'équipe qui est spécifiée par projectName. Sinon, /TeamProject spécifie le projet d'équipe qui contient l'environnement.

Pour utiliser l'option /TeamProject, vous devez également spécifier l'option /Collection.

CollectionName:collectionName

En cas d'utilisation sans /TeamProject, cible les options /Add, /Delete ou /List sur tous les environnements isolés du réseau dans la collection de projets d'équipe qui est spécifiée parcollectionName. Sinon, /Collection spécifie la collection de projets d'équipe qui contient le projet d'équipe.

Name:FQDN

Spécifie le nom de domaine qualifié complet de l'emplacement réseau qui contient l'environnement à cibler.

Vous devez spécifier les options /Name et /IP ensemble.

IP:IPAddress

Spécifie l'adresse IP de l'environnement à cibler.

Vous devez spécifier les options /Name et /IP ensemble.

Notes

Spécifiez une seule des options /Add, /Delete ou /List sur une ligne de commande TfsConfig Lab /DNS. Si vous ne spécifiez pas d'options cibles, l'opération agit sur tous les ordinateurs virtuels de tous les environnements isolés du réseau qui appartiennent à toutes les collections de projets dans la base de données Team Foundation Server.

Pour cibler les entrées DNS des environnements isolés du réseau d'un objet dans la hiérarchie d'objets Lab Management, utilisez la combinaison appropriée des options /Collection, /TeamProject et /LabEnvironment

  • L'option /LabEnvironment cible la commande à l'environnement isolé du réseau spécifié. Vous devez utiliser les options /CollectionName et /TeamProject avec l'option /LabEnvironment pour spécifier la collection de projets d'équipe et le projet d'équipe qui contiennent l'environnement.

    Utilisez le format **vstfs:///LabManagement/LabEnvironment/**environmentID pour spécifier l'URI d'environnement. Vous pouvez afficher l'identificateur d'environnement (environmnetID) dans la visionneuse d'environnement de Lab Management ou dans la description de la machine virtuelle dans la console Administrateur SCVMM.

  • L'option /TeamProject cible l'opération aux environnements réseau isolés dans le projet d'équipe spécifié. L'option /TeamProject doit être utilisée avec l'option /CollectionName et l'option /CollectionName doit spécifier la collection de projets d'équipe qui contient le projet d'équipe.

  • L'option /CollectionName cible l'opération aux environnements isolés du réseau dans la collection de projets d'équipe spécifiée.

La deuxième façon de cibler un environnement isolé du réseau est d'utiliser les options /Name et /IP pour spécifier le nom externe qualifié complet et l'adresse IP externe d'un ordinateur virtuel individuel. Vous devez spécifier à la fois les options /Name et /IP sur la ligne de commande. Vous pouvez consulter le nom externe et l'adresse IP externe d'un ordinateur virtuel dans la Visionneuse d'environnement de Lab Management ou à partir de la description de l'ordinateur virtuel dans la console Administrateur SCVMM.

Exemple

Dans le premier exemple, des enregistrements correspondant à tous les environnements isolés du réseau d'un projet d'équipe sont ajoutés à DNS. Dans le second exemple, un enregistrement DNS individuel est supprimé.

REM First example
tfsconfig lab /dns /add /collectionname:Collection0 /teamproject:Project1

REM Second example
tfsconfig lab /dns /delete /name:0b668996-2736-46d2-88ac-0733acbd0d9c.contoso.com /ip:111.00.000.000

Voir aussi

Tâches

Configuration et administration de Lab Management

Concepts

Référence de la commande TFSLabConfig

Autres ressources

Référence de la commande de laboratoire TFSConfig