Commande Unshelve (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
La commande TFVC (Team Foundation Version Control) unshelve restaure les révisions de fichiers, 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 ensemble de rayons existants du serveur.
Conditions préalables
- Pour utiliser la commande
unshelve:- Disposez de l’autorisation Lecture définie sur Autoriser.
- Disposez de l’autorisation Extraire pour les éléments de l’ensemble de étagères défini sur Autoriser.
- Pour supprimer un jeu de rayons, être propriétaire ou avoir le Administrer les modifications autorisation globale 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 d’étagères à restaurer.
<owner-name>
Spécifie le nom d’utilisateur du propriétaire du jeu d’étagères.
<item-spec>
Identifie les révisions de fichier ou de dossier pour annuler l’élément de stockage dans l’espace de travail actuel. Si ce paramètre n’est pas inclus, toutes les modifications en attente dans le jeu de rayons spécifiés 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 <item-spec> valeurs pour déterminer quels éléments se trouvent dans l’étendue, consultez Utiliser les commandes de contrôle de version Team Foundation - Utilisez des options pour modifier la façon dont une fonction de commande.
Note
Vous pouvez spécifier plusieurs arguments <item-spec>.
<username>
Fournit une valeur à l’option /login. Vous pouvez spécifier cette valeur comme DOMAIN\<username> ou <username>.
<password>
Fournit une valeur à l’option /login.
Options
option
Description
/move
Supprime le jeu d’étagères spécifié du serveur Azure DevOps après avoir supprimé correctement l’ensemble de rayons. Cette option ne peut pas être combinée avec une valeur <item-spec>.
Vous pouvez également supprimer un ensemble de rayons à l’aide de la commande shelve.
/recursive
Spécifie que la valeur <item-spec> doit être mises en correspondance de manière récursive.
/noprompt
Spécifie que TFVC ne doit pas vous inviter à entrer.
/login
Spécifie le nom d’utilisateur et le mot de passe pour authentifier l’utilisateur auprès d’Azure DevOps.
Remarques
La commande unshelve de l’utilitaire de ligne de commande tf récupère toutes les révisions de fichier de secours ou un sous-ensemble défini de toutes les révisions de fichier de secours à partir du serveur Azure DevOps. La commande stocke ensuite les révisions dans l’espace de travail actuel.
Pour dissocier un élément, il ne doit pas y avoir de révisions en attente dans l’espace de travail de destination.
Lorsque vous supprimez un ensemble de rayons, TFVC restaure chaque révision en cours 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 d’unshelve, consultez Travailler avec des jeux d’étagères.
Vous pouvez utiliser la commande unshelve pour restaurer des révisions de fichiers individuelles à partir d’un ensemble de rayons sur votre espace de travail. Après avoir exécuté la commande unshelve, exécutez la commande get pour rapprocher les modifications qui ont été vérifiées sur le serveur depuis la création du jeu de rayons.
Pour plus d’informations sur l’utilisation de l’utilitaire de ligne de commande tf, consultez Utiliser les commandes de contrôle de version Team Foundation.
Recyclage des modifications
Si vous souhaitez intégrer des révisions dans votre espace de travail actuel afin d’effectuer des révisions en cours, supprimez l’ensemble de rayons souhaité. En guise de meilleure pratique, obtenez également la dernière version de vos fichiers contrôlés par la version après unshelving.
Annuler et examiner le code d’un autre utilisateur
Vous pouvez également dissocier un ensemble de rayons pour passer en revue les modifications de l’espace de travail d’un autre utilisateur. Pour annuler l’helve pour cette raison, vous avez deux options :
La première option est appropriée lorsque les articles de secours et les articles connexes n’ont pas été révisés ou n’ont été révisés que légèrement depuis la création de l’ensemble de étagères. 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 d’étagères. 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 rayons.La deuxième option est appropriée lorsqu’une durée importante a passé ou plusieurs révisions ont été effectuées dans l’espace de travail depuis la création du jeu d’étagères. Dans ce cas, vous pouvez récupérer la version de tous les éléments associés du serveur à partir de la date et de l’heure de création du jeu d’étagères.
Vous pouvez annuler le changement de la bibliothèque d’un autre utilisateur en ajoutant le nom d’utilisateur au nom de l’ensemble de rayons. Toutefois, vous ne pouvez supprimer qu’un ensemble de rayons du serveur Azure DevOps créé par un autre utilisateur si vous disposez de l’autorisation AdminShelvedChangesets.
Si vous tentez de supprimer 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 ensemble de rayons à l’aide de tf shelve /delete. Pour plus d’informations, consultez commande Shelve. Pour supprimer automatiquement un jeu d’étagères après avoir supprimé l’ensemble du rayon, utilisez tf unshelve /move.
Exemples
L’exemple suivant ouvre la boîte de dialogue unshelve afin que vous puissiez rechercher et annuler un ensemble de rayons dans l’espace de travail actuel. Vous disposez également d’une option dans la boîte de dialogue pour que l’ensemble de rayons soit supprimé lorsque l’opération d’annulation de l’opération se termine.
c:\>tf unshelve
L’exemple suivant supprime l’ensemble de rayons buddytest_1256 dans l’espace de travail actuel et le supprime d’Azure DevOps Server :
c:\>tf unshelve /move buddytest_1256