Shelve, commande
Mise à jour : novembre 2007
Stocke un jeu de modifications en attente, avec des notes d'archivage en attente, un commentaire et une liste d'éléments de travail associés, sur le Team Foundation Server sans les archiver réellement sur le serveur de contrôle de version.
Autorisations requises
Pour utiliser la commande shelve, vous devez être le propriétaire d'un jeu de réservations ou disposer de l'autorisation Administrer les modifications réservées avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf shelve [/replace] [/comment:("comment"|@commentfile)] [shelvesetname[;owner] [/validate]
tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)]
[/recursive] shelvesetname[;owner] itemspec [/validate]
tf shelve /delete [/server:servername] shelvesetname[;owner] [/validate]
Paramètres
Argument |
Description |
|---|---|
commentfile |
Spécifie un chemin d'accès dans le système de fichiers du fichier où lire les commentaires sur le jeu de réservations. |
comment |
Spécifie le commentaire sur le jeu de réservations. |
servername |
Valeur fournie par l'utilisateur pour l'option /server. |
itemspec |
Identifie les fichiers ou dossiers à réserver. Par défaut, toutes les modifications en attente dans l'espace de travail actuel sont réservées si ce paramètre n'est pas spécifié. Pour plus d'informations sur la façon dont Team Foundation analyse les spécifications d'éléments (itemspecs) afin de déterminer quels éléments se trouvent dans la portée, consultez Options de ligne de commande. |
shelvesetname |
Spécifie le nom par lequel le jeu de réservations peut être récupéré depuis le serveur Team Foundation. Vous pouvez spécifier une combinaison existante de shelvesetname et de owner, mais seulement si /replace est également spécifié. Vous devez fournir une valeur pour ce paramètre. |
owner |
Identifie par nom d'utilisateur le propriétaire actuel ou prévu du jeu de réservations. La propriété du jeu de réservations est assignée par défaut à l'utilisateur actuel si le propriétaire n'est pas spécifié. |
Option |
Description |
|---|---|
/move |
Supprime les modifications en attente de l'espace de travail suite à une opération de réservation réussie. |
/replace |
Remplace le jeu de réservations existant par le même nom et le même propriétaire que celui que vous spécifiez. |
/delete |
Supprime le jeu de réservations spécifié. Seule l'option /server peut être combinée avec cette option. Si vous n'incluez pas l'option /noprompt , un message de confirmation apparaît lorsque l'option /delete est spécifiée. |
/comment |
Ajoute un commentaire spécifié qui décrit les modifications réservées. |
/recursive |
Réserve tous les éléments contenus dans le dossier spécifié du jeu de réservations et ses sous-dossiers si la spécification d'éléments (itemspec) que vous fournissez est un dossier. |
/server |
Spécifie sur quel serveur de contrôle de version Team Foundation créer, modifier ou supprimer le jeu de réservations spécifié. |
/noprompt |
Supprime les invites de saisie. |
/validate |
Valide uniquement si cette option n'est pas combinée avec l'option /noprompt. Cette option active la case à cocher de validation dans la boîte de dialogue Réserver - Fichiers sources lorsqu'elle s'ouvre. Lorsque la case à cocher de validation est activée, la boîte de dialogue évalue les stratégies d'archivage et vérifie que les notes d'archivage requises ont été remplies. Cette option est utile lorsque les modifications sont remises par quelqu'un d'autre pour révision et archivage. |
Notes
La commande shelve de l'utilitaire en ligne de commande tf sauvegarde les modifications en attente, une liste d'éléments de travail associés, les notes d'archivage en cours et les commentaires dans un jeu de réservations sur le serveur Team Foundation Server. Un jeu de réservations est très similaire à un ensemble de modifications qui ne serait pas validé sur le serveur. Tout comme un ensemble de modifications, un jeu de réservations peut être récupéré à partir du serveur dans un espace de travail local par tout utilisateur doté des autorisations suffisantes.
La réservation est une alternative à l'archivage de modifications en attente qui n'ont pas été suffisamment testées. Utilisez la réservation lorsque vous souhaitez interrompre votre travail :
Partagez un jeu de fichiers de travail locaux avec un autre développeur ou testeur sans archiver vos modifications sur le serveur de contrôle de version.
Mettez temporairement de côté un groupe de modifications en attente sans les archiver, pour pouvoir travailler sur une tâche plus urgente. Une fois le travail prioritaire terminé, vous pouvez restaurer vos modifications réservées à l'aide de la Unshelve, commande.
Si vous incluez l'option /move, la commande shelve ramène toutes les révisions de fichiers réservées à leurs versions d'espace de travail de base, c'est-à-dire la dernière version récupérée sur le serveur dans l'espace de travail actuel. Plus précisément, l'option /move permet de s'assurer que pour tous les éléments que vous réservez :
Utilise Undo pour annuler les modifications réservées. Les fichiers qui représentaient des ajouts en attente sont supprimés de l'espace de travail.
Les versions d'espace de travail de base de tous les fichiers pour lesquels il existe des modifications en attente sont récupérées du serveur dans l'espace de travail actuel.
Tous les éléments figurant dans l'espace de travail actuel sont marqués en lecture seule.
Si vous incluez l'option /delete , Team Foundation supprime définitivement le jeu de réservations spécifié du serveur Team Foundation.
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Exemples
L'exemple suivant crée un nouveau jeu de réservations sur le Team Foundation Server appelé Reflector_BuddyTest, assigne la propriété à l'utilisateur Hans, puis retourne tous les éléments de l'espace de travail actuel à la version la plus récente téléchargée lors de la dernière opération get et définit l'état de lecture seule.
c:\projects> tf shelve Reflector_BuddyTest;Hans /move
L'exemple suivant supprime du serveur le jeu de réservations existant "new-feature", crée un nouveau jeu de réservations portant ce nom et conserve toutes les modifications en attente dans l'espace de travail actuel.
c:\projects> tf shelve new-feature /replace
L'exemple suivant crée un jeu de réservations nommé HelloWorld_TestMe qui inclut toutes les modifications en attente de tous les fichiers .cs dans le dossier de travail C:\projects et ses sous-dossiers.
c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive
L'exemple suivant supprime le jeu de réservations HelloWorld_24.
c:\projects> tf shelve HelloWorld_24 /delete
Voir aussi
Tâches
Comment : réserver et déréserver des modifications en attente
Concepts
Utilisation des jeux de réservations du contrôle de version
Référence
Syntaxe de ligne de commande (Team System)