Commande Shelvesets (Team Foundation Version Control)

  • Article

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

Visual Studio 2019 | Visual Studio 2022

La commande shelvesets Team Foundation Version Control (TFVC) affiche des informations sur un ensemble de modifications réservées.

Prérequis

Pour utiliser la commande shelvesets, vous devez disposer de l’autorisation Lecture et de l’autorisation Extraire définie sur Autoriser les éléments dans les jeux de réservations. Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

tf shelvesets [/owner:ownername] [/format:(brief|detailed)] [/collection:TeamProjectCollectionUrl]] [/login:username,[password]] shelvesetname

Paramètres

Arguments

Argument Description
<ownername> Fournit une valeur telle que * ou DOMAIN\username à l’option /owner.
<shelvesetname> Nom de l’ensemble du jeu de réservations.
<TeamProjectCollectionUrl> L’URL de la collection de projets qui contient un ensemble de modifications réservées sur lesquelles vous souhaitez afficher des informations, par exemple http://myserver:8080/tfs/DefaultCollection.
<username> Fournit une valeur à l’option /login. Vous pouvez définir une valeur de nom d’utilisateur en tant que DOMAIN\username ou username.

Options

Option Description
/owner Spécifie un ou plusieurs propriétaires de jeu de réservations. Vous pouvez utiliser des caractères génériques.
/format Spécifie le type de format dans lequel afficher les informations de jeu de réservations.

Brief affiche le nom de l’ensemble de jeu de réservations, le nom de l’utilisateur qui l’a créé et un commentaire de jeu de réservations, s’il en existe un. Detailed affiche le nom, le propriétaire et le commentaire de l’ensemble de jeu de réservations, en plus d’une liste d’éléments de travail associés et de toutes les notes d’archivage. Brief est la valeur par défaut.
/collection Spécifie la collection de projets.
/login Spécifie le nom d’utilisateur et le mot de passe pour authentifier l’utilisateur auprès d’Azure DevOps.

Notes

Les jeux de réservations sont créés par la commande Shelve. Les jeux de réservations sont stockés sur le serveur Azure DevOps et peuvent être récupérés dans un espace de travail par tout utilisateur disposant d’autorisations suffisantes à l’aide de la commande Unshelve.

Contrairement à un ensemble de modifications, un jeu de réservations est une entité sans version. Si vous ou un autre utilisateur supprimez les éléments d’un ensemble de jeu de réservations, modifiez plusieurs fichiers et re-réservez l’ensemble de jeu de réservations, TFVC ne crée pas de nouvelle version des éléments pour une comparaison ultérieure. TFVC ne conserve aucun enregistrement de qui a modifié les éléments, quand ou comment. Pour plus d’informations sur la détermination de l’utilisation ou de l’archivage d’un ensemble de modifications en attente et d’une vue d’ensemble générale de la bibliothèque, consultez Travailler avec des jeux de réservations.

Pour plus d’informations sur les révisions de fichiers sources individuelles dans un jeu de réservations particulier, vous pouvez utiliser la commande Status avec l’option /shelveset.

Vous pouvez comparer une révision réservée à sa version de jeu de réservations de base sans annuler la suppression de l’élément dans votre espace de travail. Vous pouvez utiliser cette fonctionnalité pour effectuer une révision rapide du code d’homologue.

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

Exemples

L’exemple suivant affiche des informations sur le jeu de réservations BuddyTest_23 du serveur Azure DevOps sur lequel le répertoire actif est mappé :

c:\projects>tf shelvesets BuddyTest_23

L’exemple suivant répertorie les jeux de réservations appartenant à Pat :

c:\projects>tf shelvesets /owner:Pat

L’exemple suivant affiche des informations sur tous les jeux de réservations sur le serveur Azure DevOps sur lequel le répertoire actif est mappé :

c:\projects>tf shelvesets /owner:*