Partager via

Commande Changeset

  • Article

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

Visual Studio 2019 | Visual Studio 2022

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

Conditions préalables

Pour utiliser la commande changeset, disposez de l’autorisation Lecture définie sur Autoriser pour tous les fichiers ou dossiers dans l’ensemble de modifications pour lequel 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éé le jeu de modifications ou un utilisateur qui a le Réviser les modifications apportées à d’autres utilisateurs autorisation globale.

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 un 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 de field=value avec une par ligne.
<TeamProjectCollectionUrl> URL de la collection de projets qui contient un ensemble de modifications sur lequel vous souhaitez afficher des informations ou dont les attributs que vous souhaitez modifier, par exemple, http://myserver:8080/tfs/DefaultCollection.
<username> Fournit une valeur à l’option /user. Vous pouvez spécifier cet argument comme Domain\username ou username.
<changesetnumber> Identifie le jeu de modifications à réviser ou à modifier. Impossible d’utiliser /latest.

Option

option Description
/comment Remplace le commentaire de l’ensemble de modifications 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 le jeu de modifications le plus récent. Impossible d’utiliser <changesetnumber>.
/noprompt Supprime toutes les invites d’entrée à partir de vous.
/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.

Remarques

Un ensemble de modifications est un ensemble de révisions de fichiers et de dossiers qui ont été validées sur le serveur de contrôle 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 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 Visual Studio Details for Changeset 8675309 - Source Files boîte de dialogue, et remplace le commentaire existant par Il s’agit d’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 Visual Studio Details for Changeset 8675309 - Source Files, sélectionnez Enregistrer pour associer le commentaire au jeu de modifications.

L’exemple suivant fournit deux notes d’archivage à associer au jeu 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 au jeu 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 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 le jeu 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 Changeset de 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