Unshelve, commande

Restaure dans l'espace de travail actuel des révisions de fichier, des notes d'archivage, des commentaires et des associations d'éléments de travail réservés ou supprime du serveur un jeu de réservations existant.

Autorisations requises

Pour utiliser la commande unshelve, vous devez disposer de l'autorisation Lire avec la valeur Autoriser et de l'autorisation Extraire pour les éléments du jeu de réservations avec la valeur Autoriser. En outre, pour supprimer un jeu de réservations, vous devez en être le propriétaire ou disposer de l'autorisation globale Administrer les modifications réservées avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

tf unshelve [/move] [shelvesetname[;username]] itemspec 
[/recursive] [/noprompt][/login:username,[password]]

Paramètres

Argument	Description
shelvesetname	Nom du jeu de réservations à restaurer.
ownername	Nom du propriétaire du jeu de réservations.
Itemspec	Identifie les révisions de fichier ou de dossier à déréserver dans l'espace de travail actuel. Si ce paramètre n'est pas inclus, toutes les modifications en attente dans le jeu de réservations spécifié sont déréservées par défaut. Les chemins d'accès au serveur ne sont pas autorisés. Pour plus d'informations sur la façon dont Team Foundation analyse les spécifications d'éléments afin de déterminer quels éléments se trouvent dans la portée, consultez Options de ligne de commande. Remarque Vous pouvez spécifier plusieurs arguments Itemspec.
username	Fournit une valeur pour l'option /login. Vous pouvez spécifier une valeur de nom d'utilisateur comme DOMAINE\NomUtilisateur ou NomUtilisateur.

Notes

La commande unshelve de l'utilitaire en ligne de commande tf récupère dans l'espace de travail actuel soit toutes les révisions de fichier réservées, soit un sous-ensemble défini de toutes les révisions de fichier réservées depuis le serveur Team Foundation.

Pour déréserver un élément, il ne doit pas avoir de révision en attente dans l'espace de travail de destination.

Lorsque vous déréservez un jeu de réservations, Team Foundation restaure chaque révision réservée dans l'espace de travail de destination en tant que modification en attente tant que la révision n'est pas en conflit avec une modification déjà en attente dans l'espace de travail. Pour plus d'informations sur le processus de déréservation, consultez Utilisation de jeux de réservations.

Vous pouvez utiliser la commande unshelve pour restaurer dans votre espace de travail des révisions de fichier individuelles depuis un jeu de réservations. Vous devez exécuter la commande Get après une déréservation pour effectuer un rapprochement de toutes les modifications archivées sur le serveur depuis la création du jeu de réservations.

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.

Recyclage des modifications réservées

Si vous souhaitez intégrer des révisions réservées à votre espace de travail actuel pour effectuer des révisions au fur et à mesure, déréservez le jeu de réservations voulu. Il est conseillé d'obtenir également la version la plus récente de vos fichiers sous contrôle de version après déréservation.

Déréservation et révision du code d'un autre utilisateur

Vous pouvez également déréserver un jeu de réservations afin de réviser les modifications provenant de l'espace de travail d'un autre utilisateur. La déréservation dans un tel but peut se faire de deux manières.

• Si les éléments réservés et les éléments auxquels ils sont associés n'ont pas été modifiés, ou s'ils ont été légèrement modifiés depuis la création du jeu de réservations, vous pouvez récupérer la version de base de tous les éléments associés dans l'espace de travail du propriétaire du jeu de réservations. Pour ce faire, utilisez une variation de la commande suivante : tf get * /version;Wworkspacename, workspacename désignant le nom de l'espace de travail à partir duquel l'autre utilisateur a créé le jeu de réservations.

• Si un laps de temps important s'est écoulé ou si plusieurs révisions ont été apportées dans l'espace de travail depuis la création du jeu de réservations, récupérez la version de tous les éléments associés sur le serveur à compter de la date et de l'heure de création du jeu de réservations.

Vous pouvez déréserver la modification réservée d'un autre utilisateur en ajoutant le nom de l'utilisateur au nom du jeu de réservations. Vous ne pouvez toutefois supprimer un jeu de réservations du serveur Team Foundation Server créé par un autre utilisateur que si vous disposez de l'autorisation AdminShelvedChangesets.

Si vous tentez de déréserver un élément pour lequel une modification en attente existe dans l'espace de travail de destination, Team Foundation ne fusionnera pas les différences entre éléments et ne récupérera pas la révision dans votre espace de travail.

Vous pouvez supprimer un jeu de réservations à l'aide de tf shelve /delete. Pour plus d'informations, consultez Shelve, commande. Pour supprimer automatiquement un jeu de réservations après l'avoir entièrement déréservé, utilisez tf unshelve /move.

Exemples

L'exemple suivant ouvre la boîte de dialogue Déréserver pour vous permettre de rechercher et de déréserver un jeu de réservations dans l'espace de travail actuel. La boîte de dialogue vous offre également une option permettant de supprimer le jeu de réservations à l'issue de l'opération de déréservation.

c:\>tf unshelve

L'exemple suivant déréserve le jeu de réservations buddytest_1256 dans l'espace de travail actuel et le supprime de Team Foundation Server.

c:\>tf unshelve /move buddytest_1256

Voir aussi

Tâches

Réserver et déréserver des modifications en attente

Référence

Syntaxe de ligne de commande (Contrôle de version)

Shelve, commande

Changeset, commande

Concepts

Utilisation de jeux de réservations

Autres ressources

Commandes de l'utilitaire en ligne de commande Tf