Commande Changeset

  • Article

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

Visual Studio 2019 | Visual Studio 2022

Affiche des informations sur les attributs, tels que les commentaires et les notes d’archivage, associés à un ensemble de modifications, et vous permet de les modifier.

Prérequis

Pour utiliser la commande changeset, vous devez disposer de l’autorisation Lecture définie sur Autoriser les fichiers ou dossiers de l’ensemble de modifications pour lesquels vous souhaitez afficher des informations complètes. Les seuls utilisateurs qui peuvent modifier les notes et commentaires associés à un ensemble de modifications sont les utilisateurs qui ont créé l’ensemble de modifications ou un utilisateur disposant de l’autorisation globale Réviser les modifications d’un autre utilisateur.

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

Syntaxe

tf changeset [/comment:("comment"|@commentfile)] 
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]] 
[changesetnumber | /latest][/login:username,[password]]

Paramètres

Argument

Argument Description
comment Fournit un commentaire sur l’archivage.
@<commentfile> Spécifie le chemin d’accès d’un fichier sur le disque qui contient le commentaire utilisé pour l’archivage.
<NoteFieldName>=<NoteFieldValue> Définit la valeur du champ de note d’archivage. Vous pouvez fournir plusieurs expressions field=value séparées par des points-virgules.
@<notefile> Fournit le chemin d’accès d’un fichier sur disque qui contient des noms et des valeurs de champ de note d’archivage au format field=value, un par ligne.
<TeamProjectCollectionUrl> L’URL de la collection de projets qui contient un ensemble de modifications sur lequel vous souhaitez afficher des informations ou dont vous souhaitez modifier les attributs, par exemple, http://myserver:8080/tfs/DefaultCollection.
<username> Fournit une valeur à l’option /user. Vous pouvez spécifier cet argument en tant que Domain\username ou username.
<changesetnumber> Identifie l’ensemble de modifications à passer en revue ou à modifier. Impossible à utiliser avec /latest.

Option

Option Description
/comment Remplace le commentaire d’ensemble de modifications qui a été créé pendant le processus d’archivage par un nouveau commentaire.
/notes Fournit une ou plusieurs notes d’archivage à associer à l’ensemble de modifications.
/latest Spécifie l’ensemble de modifications le plus récent. Impossible à utiliser avec <changesetnumber>.
/noprompt Supprime toutes les invites d’entrée de votre part.
/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

Un ensemble de modifications est un ensemble de révisions de fichiers et de dossiers qui ont été validées sur le serveur de gestion de version Team Foundation dans le cadre du même événement d’archivage. Pour plus d’informations, consultez Utilisation des ensembles de modifications.

Vous pouvez utiliser la commande changeset pour afficher les attributs d’un ensemble de modifications et modifier ses propriétés. Vous pouvez utiliser la commande history pour déterminer l’ensemble de modifications sur lequel vous souhaitez obtenir des informations. Pour plus d’informations, consultez Commande d’historique.

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.

Exemples

L’exemple suivant affiche des informations détaillées sur l’ensemble de modifications 8675309 dans un format modifiable dans la boîte de dialogue Détails de Visual Studio pour l’ensemble de modifications 8675309 - Fichiers sources, et remplace le commentaire existant par Ceci est un nouveau commentaire.

c:\projects>tf changeset /comment:"This is a new comment." 8675309

Après avoir entré la commande, dans la boîte de dialogue Détails de Visual Studio pour l’ensemble de modifications 8675309 - Fichiers sources, sélectionnez Enregistrer pour associer le commentaire à l’ensemble de modifications.

L’exemple suivant fournit deux notes d’archivage à associer à l’ensemble de modifications.

c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309

L’exemple suivant fournit deux notes d’archivage qui incluent des espaces dans les valeurs et les noms à associer à l’ensemble de modifications.

c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309

L’exemple suivant associe les notes d’archivage incluses dans le fichier notes.txt à l’ensemble de modifications 8675309.

c:\projects>tf changeset /notes:@notes.txt 8675309

Où le fichier notes.txt peut être au format suivant :

field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;

L’exemple suivant remplace le commentaire existant pour l’ensemble de modifications 8675309 et affiche des informations sur l’ensemble de modifications dans la fenêtre d’invite de commandes. Cet exemple n’ouvre pas la boîte de dialogue Ensemble de modifications Visual Studio.

c:\projects>tf changeset /comment:"This is an automatically generated comment." /noprompt 8675309

L’exemple suivant affiche des informations non modifiables sur l’ensemble de modifications 8675309 dans la fenêtre d’invite de commandes.

c:\projects>tf changeset 8675309 /noprompt

Exemple de sortie :

Changeset: 8675309
User: DOMAIN\JohnG
Date: 01/21/2004 21:03:45
Comment:  This check-in fixes issues in several features.  I also refactored some items in buf.c into a new file named bif.c because buf.c was too hard to parse.
Items:
    $/baz/proj/bif.c           Added
    $/baz/proj/buf.c          Modified, Renamed
Work Items:
    34527     The "Access Denied" message isn't descriptive enough.
    35628     The UI flickers when I press the '8', 'y', 'Ctrl', and 'End' buttons at the same time.
Check-in Notes:
    Code Reviewer:  ShellM
    Performance Reviewer: ShellM
    Security Reviewer: ShellM