Commande Déréserver (Team Foundation Version Control)

  • Article

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

La commande Team Foundation Version Control (TFVC) unshelve restaure les révisions de fichiers réservés, les notes d’archivage, les commentaires et les associations d’éléments de travail dans l’espace de travail actuel. Vous pouvez également utiliser la commande unshelve pour supprimer un jeu de réservations existant du serveur.

Prérequis

  • To use the unshelve command:
    • Vous devez disposer de l’autorisation Lire définie sur Autoriser.
    • Vous devez disposer de l’autorisation Extraire pour les éléments du jeu de réservations définie sur Autoriser.
  • 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 définie sur Autoriser.

Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

tf unshelve [/move] [<shelveset-name>[;<owner-name>]] <item-spec> 
[/recursive] [/noprompt][/login:<username>,[<password>]]

Paramètres

Les sections suivantes décrivent les arguments et les options de la commande unshelve.

Arguments

Argument

Description

<shelveset-name>

Spécifie le nom du jeu de réservations à restaurer.

<owner-name>

Spécifie le nom d’utilisateur du propriétaire du jeu de réservations.

<item-spec>

Identifie les révisions de fichier ou de dossier à supprimer 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é ne sont pas incluses, par défaut. Les chemins d’accès au serveur ne sont pas autorisés.

Pour plus d’informations sur la façon dont TFVC analyse les valeurs <item-spec> pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser les commandes de gestion de version Team Foundation, Utiliser des options pour modifier le fonctionnement d’une commande.

Notes

Vous pouvez définir plusieurs arguments <item-spec>.

<username>

Fournit une valeur à l’option /login. Vous pouvez spécifier DOMAIN\<username> ou <username> pour cette valeur.

<password>

Fournit une valeur à l’option /login.

Options

Option

Description

/move

Supprime le jeu de réservations spécifié du serveur Azure DevOps après avoir correctement supprimé le jeu de réservations. Cette option ne peut pas être combinée avec la valeur <item-spec>.

Vous pouvez également supprimer un jeu de réservations à l’aide de la commande shelve.

/recursive

Spécifie que la valeur <item-spec> doit être mise en correspondance de manière récursive.

/noprompt

Spécifie que TFVC ne doit pas vous inviter à entrer quelque chose.

/login

Spécifie le nom d’utilisateur et le mot de passe pour authentifier l’utilisateur auprès d’Azure DevOps.

Notes

La commande unshelve de l’utilitaire de ligne de commande tf récupère toutes les révisions de fichier réservé ou un sous-ensemble défini de toutes les révisions de fichier réservé à partir du serveur Azure DevOps. La commande stocke ensuite les révisions dans l’espace de travail actuel.

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

Lorsque vous déréservez un jeu de réservations, TFVC 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 ce qui se passe pendant le processus de déréservation, consultez Utiliser des jeux de réservations.

Vous pouvez utiliser la commande unshelve pour restaurer des révisions de fichiers individuelles à partir d’un jeu de réservations dans votre espace de travail. Après avoir exécuté la commande unshelve, exécutez la commande get pour rapprocher toutes les modifications qui ont été archivées dans le serveur depuis la création du jeu de réservations.

Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de gestion de version Team Foundation.

Recycler les modifications apportées aux réservations

Si vous souhaitez intégrer des révisions réservées dans votre espace de travail actuel afin d’effectuer des révisions en cours, déréservez le jeu de réservations souhaité. En guise de bonne pratique, obtenez également la dernière version de vos fichiers à version contrôlée après une déréservation.

Déréservez et passez en revue le code d’un autre utilisateur

Vous pouvez également déréserver un jeu de réservations afin de passer en revue les modifications apportées à l’espace de travail d’un autre utilisateur. Pour déréserver pour cette raison, vous avez deux options :

  • La première option est appropriée lorsque les éléments réservés et les éléments associés n’ont pas été révisés, ou n’ont été révisés que légèrement depuis la création du jeu de réservations. Dans ce cas, vous pouvez récupérer la version de base de tous les éléments associés à partir de l’espace de travail du propriétaire du jeu de réservations. Pour utiliser cette option, exécutez une variante de la commande suivante : tf get \* /version;W<workspace-name>, où <workspace-name> est le nom de l’espace de travail à partir duquel l’autre utilisateur a créé le jeu de réservations.

  • La deuxième option est appropriée lorsque beaucoup de temps s’est écoulé ou que plusieurs révisions ont été apportées à l’espace de travail depuis la création du jeu de réservations. Dans ce cas, vous pouvez récupérer la version de tous les éléments associés à partir du serveur à compter de la date et de l’heure de création du jeu de réservations.

Vous pouvez annuler la modification réservée d’un autre utilisateur en ajoutant le nom d’utilisateur au nom du jeu de réservations. Toutefois, vous ne pouvez supprimer un jeu de réservations du serveur Azure DevOps créé par un autre utilisateur que si vous disposez de l’autorisation AdminShelvedChangesets.

Si vous tentez de déréserver un élément avec une modification en attente dans l’espace de travail de destination, TFVC ne fusionne pas les différences entre les éléments et ne récupère 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 Commande Réserver. Pour supprimer automatiquement un jeu de réservations après avoir déréservé l’ensemble du jeu de réservations, utilisez tf unshelve /move.

Exemples

L’exemple suivant ouvre la boîte de dialogue Déréserver afin que vous puissiez rechercher et déréserver un jeu de réservations dans l’espace de travail actuel. Vous avez également la possibilité dans la boîte de dialogue de supprimer le jeu de réservations une fois l’opération de déréservation terminée.

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 Azure DevOps Server :

c:\>tf unshelve /move buddytest_1256