Commande Undo (Team Foundation Version Control)

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

Visual Studio 2019 | Visual Studio 2022

La commande undo Team Foundation Version Control (TFVC) ignore une ou plusieurs modifications en attente apportées aux fichiers ou dossiers.

Prérequis

Par défaut, les membres du groupe Contributeurs du projet ont les autorisations nécessaires pour contribuer à un référentiel et utiliser la commande undo dans leurs propres espaces de travail. Pour annuler les modifications en attente dans l’espace de travail d’un autre utilisateur, vous devez disposer de l’autorisation Administrer les espaces de travail défini sur Autoriser. Pour plus d’informations, consultez Autorisations TFVC par défaut.

Syntaxe

tf undo [/workspace:<workspace-name>[;<workspace-owner>]]
[/recursive] <item-specification> [/noprompt] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>]

Paramètres

Paramètre

Description

/collection:<team-project-collection-url>

Spécifie l’URL de la collection de projets qui contient les éléments, par exemple, https://myserver:8080/tfs/DefaultCollection.

Si vous n’utilisez pas l’option /workspace, la collection de projets qui contient l’espace de travail qui mappe le répertoire actif est utilisée par défaut.

<item-specification>

Spécifie la portée des éléments. Vous pouvez spécifier plusieurs arguments <item-specification>. Pour obtenir la syntaxe, consultez Utiliser les commandes de contrôle de version Team Foundation.

/login

Spécifie le compte d'utilisateur pour exécuter la commande. Consultez Utiliser les commandes de contrôle de version Team Foundation.

/noprompt

Supprime l'affichage des fenêtres et les boîtes de dialogue et redirige les données de production à l'invite de commandes. Consultez Utiliser les commandes de contrôle de version Team Foundation.

/recursive

Annule de manière récursive des modifications apportées aux éléments du répertoire spécifié et tous les sous-répertoires.

/workspace <workspace-name>[;<workspace-owner>]

Spécifie le nom de l’espace de travail dans lequel annuler les modifications en attente. S'il n'est pas spécifié, l'espace de travail est celui qui mappe le répertoire actif.

Vous pouvez spécifier <workspace-owner> pour annuler une modification en attente dans un espace de travail qui appartient à un utilisateur spécifique. Si vous ne fournissez pas cet argument, l’espace de travail appartenant à l’utilisateur actuel est utilisé par défaut. Toutefois, si vous fournissez l’argument /login avec un nom d’utilisateur, l’espace de travail appartenant à cet utilisateur est utilisé. Vous devez disposer de l’autorisation UndoOther définie sur Autoriser pour annuler les modifications dans l’espace de travail d’un autre utilisateur.

Notes

Vous pouvez utiliser la commande undo pour annuler une modification en attente dans un espace de travail distant qui est toujours en cours d’utilisation. Avant de continuer à travailler dans cet espace de travail, un utilisateur doit se connecter à l’ordinateur qui héberge l’espace de travail et obtenir les éléments affectés par l’opération d’annulation. Pour plus d’informations sur la commande get et son argument /all, consultez commande Get.

Notes

Pour chaque élément avec une modification en attente, la commande undo détermine si le fichier a été modifié sur le disque. Si le fichier a été modifié et l'option /noprompt n'a pas été spécifiée, les invites du système vous demandent de confirmer que vous voulez continuer. Sur le clavier, sélectionnez :

  • N pour laisser la modification en place.
  • Y pour continuer uniquement avec la modification actuelle.
  • A pour continuer avec ce fichier et tous les autres fichiers modifiés détectés.

La commande undo supprime les verrous sur les éléments spécifiés.

Exemples

La commande suivante supprime les modifications en attente apportées au fichier program.cs :

c:\code\SiteApp\Main\SolutionA\Project1>tf undo program.cs

La commande suivante supprime les modifications en attente de tous les éléments du dossier c:\code\SiteApp\Main et de ses sous-dossiers :

c:\code\SiteApp\Main>tf undo * /recursive

La commande suivante supprime les modifications en attente apportées au fichier program.cs dans la collection et l’espace de travail distant spécifiés :

c:\>tf undo /collection:https://fabrikam-3:8080/tfs/DefaultCollection
/workspace:FABRIKAM-1;PatI $/SiteApp/Main/SolutionA/Project1/program.cs

Conseils

  • Pour afficher la liste des modifications en attente dans l’espace de travail actuel ou dans un espace de travail distant, utilisez la commande status. Pour plus d’informations, consultez commande Status.
  • Vous pouvez utiliser l’option /workspace et, si nécessaire, l’option /collection, pour annuler les modifications sur un ordinateur de développement distant. Cette fonctionnalité est particulièrement utile dans les cas où un fichier a été vérifié et éventuellement verrouillé sur un ordinateur de développement auquel vous ne pouvez pas accéder. Pour plus d’informations, consultez l’explication de l’argument /workspace, plus haut dans cet article.
  • Parfois, vous devez nettoyer votre espace de travail, par exemple lorsque votre travail est interrompu par une tâche plus urgente. Si vous souhaitez conserver les modifications en attente au lieu de les annuler, vous pouvez les suspendre à l’aide de la commande shelve. Pour plus d’informations, consultez commande Shelve. Vous pouvez également conserver la position de vos fenêtres ouvertes, points d’arrêt et autres signaux importants. Pour plus d’informations, consultez Suspendre votre travail et gérer vos jeux de réservations.
  • En plus d’annuler les modifications en attente, vous pouvez également ignorer les modifications qui ont déjà été archivées. Pour plus d’informations, consultez commande Undelete et commande Rollback (Team Foundation Version Control).