Partager via

Personnalisation et gestion des types de liens (witadmin)

  • Article

Vous pouvez gérer les types de liens définis pour une collection de projets d'équipe à l'aide des commandes witadmin suivantes.

  • deactivatelinktype : désactive le type de lien spécifié. Les utilisateurs ne seront plus en mesure de créer des liens de ce type. Les liens existants de ce type continueront à fonctionner correctement.

  • deletelinktype : supprime définitivement le type de lien spécifié de la base de données. Tous les liens définis avec ce type de lien sont également supprimés.

  • exportlinktype : exporte les définitions des types de liens. Vous pouvez exporter la définition d'un type de lien unique ou tous les types de liens définis pour le serveur.

  • importlinktype : importe les définitions des types de liens d'un fichier XML. Si un type de lien associé au même nom de référence existe déjà, il est mis à jour pour correspondre au type de lien importé. Si le type de lien n'existe pas, un nouveau type de lien est créé.

  • listlinktypes : affiche l'ensemble de types de liens disponibles sur un serveur.

  • reactivatelinktype : réactive le type de lien spécifié, et éventuellement lui assigne un nouveau nom.

L'utilitaire en ligne de commande witadmin se trouve dans Lecteur:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE sur l'ordinateur client qui exécute Team Explorer. 

Notes

Vous pouvez créer et modifier des types de liens à l'aide de l'éditeur de processus, un outil puissant pour Visual Studio. Cet outil n'est pas pris en charge. Pour plus d'informations, consultez la page suivante sur le site Web Microsoft : Outils puissants dédiés à Team Foundation Server - Avril 2010 (page éventuellement en anglais)

Autorisations requises

Pour la collection de projets dans laquelle les types de liens sont définis, vous devez disposer des autorisations suivantes :

  • Pour répertorier ou exporter des types de liens, vous devez être membre du groupe Readers ou disposer de l'autorisation Afficher les éléments de travail avec la valeur Autoriser

  • Pour supprimer, importer ou réactiver des types de liens, vous devez être membre du groupe de sécurité Team Foundation Administrators ou du groupe de sécurité Administrateurs de projet.

Pour plus d'informations, consultez Autorisations de Team Foundation Server et Groupes, autorisations et rôles par défaut de Team Foundation Server.

Notes

Même si vous vous connectez avec des autorisations d'administration, vous devez ouvrir une fenêtre d'invite de commandes avec élévation de privilèges 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 le site Web Microsoft : Contrôle de compte d'utilisateur.

witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

Paramètres

Paramètre

Description

/collection:CollectionURL

Spécifie l'URI de la collection du projet d'équipe. Le format pour l'URI est le suivant :http://ServerName:Port/VirtualDirectoryName/CollectionName

Par exemple :

http//NomServeur: 8080/tfs/Collection0

Si aucun répertoire virtuel n'est utilisé, le format de l'URI est le suivant :

http://NomServeur:Port/NomCollection

/n:LinkName

Nom ou nom de référence du type de lien à désactiver ou supprimer.

/f:FileName

Fichier XML de types de liens. Obligatoire pour l'importation, facultatif pour l'exportation. Si vous omettez ce paramètre, le résultat de la commande s'affiche.

/e:encoding

Nom d'un .NET Framework 2.0 qui encode le format. L'encodage spécifié sera utilisé pour exporter ou importer les données XML. Par exemple, /e:utf-7 spécifie l'encodage (UTF-7) Unicode. Si vous omettez ce paramètre, witadmin essaie de détecter l'encodage, et si la détection échoue, witadmin utilise UTF-8.

/v

Valide le type de lien XML sans l'importer.

/noprompt

Désactive l'invite pour la confirmation.

/? ou help

Affiche de l'aide sur la commande dans la fenêtre d'invite de commandes.

Notes

Pour la structure du schéma de définition de type de lien, consultez Utilisation des types de liens.

Exemples

Sauf spécification contraire, les valeurs suivantes s'appliquent dans chaque exemple :

  • URI pour la collection de projets d'équipe : http://AdventureWorksServer:8080/AWTeam/Collection1

  • Nom du serveur : AdventureWorksServer

  • Nom du fichier d'entrée ou de sortie : myLinkTypes.xml

  • Nom du type de lien : mylinktype

  • Encodage par défaut : UTF-8

Afficher les types de liens

La commande suivante affiche les types de liens personnalisés définis pour Team Foundation AdventureWorksServer.

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Afficher la définition d'un type de lien

L'exemple suivant affiche la définition du type de lien dans la fenêtre d'invite de commandes :

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Désactiver, puis réactiver un type de lien

Les exemples suivants désactivent le type de lien, mylinktype, puis le réactivent :

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype

Exporter la définition d'un type de lien

La commande suivante exporte la définition de tous les types de liens vers le fichier, mylinktype.xml :

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

Importer la définition des types de liens

L'exemple suivant importe la définition des types de lien définis dans le fichier XML :

witadmin importlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

Voir aussi

Tâches

Ajouter un type de lien

Concepts

Utilisation des types de liens

Liaison d'éléments de travail (Agile)

Autres ressources

Liaison d'éléments de travail (CMMI)

Création de relations entre des éléments de travail et d'autres ressources

witAdmin : administration des objets de suivi des éléments de travail