Changeset, commande
Affiche des informations sur les attributs, tels que les commentaires et les notes d'archivage associés à un ensemble de modifications, et permet de modifier ces attributs.
Autorisations requises
Pour utiliser la commande changeset, vous devez disposer de l'autorisation Lire avec la valeur Autoriser pour tous les fichiers ou dossiers contenus dans l'ensemble de modifications pour lequel vous souhaitez afficher des informations complètes. Les seuls utilisateurs autorisés à modifier les notes et les commentaires associés à un ensemble de modifications sont ceux qui ont créé l'ensemble de modifications ou qui disposent de l'autorisation globale <ui>Modifier les modifications des autres utilisateurs</ui>. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
tf changeset [/comment:("comment"|@commentfile)]
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]]
[changesetnumber | /latest][/login:username,[password]]
Paramètres
Argument |
Description |
|---|---|
comment |
Fournit un commentaire sur l'archivage. |
@commentfile |
Spécifie le chemin d'accès d'un fichier sur disque contenant le commentaire utilisé pour l'archivage. |
NoteFieldName=NoteFieldValue |
Définit la valeur du champ de la note d'archivage. Vous pouvez fournir plusieurs expressions "field=value" séparées par un point-virgule. |
@notefile |
Fournit le chemin d'accès d'un fichier sur disque contenant les noms et les valeurs du champ de la note d'archivage, au format "field=value", à raison d'un par ligne. |
TeamProjectCollectionUrl |
URL de la collection de projets d'équipe qui contient un ensemble de modifications au sujet duquel vous souhaitez afficher les informations ou dont vous souhaitez modifier les attributs (par exemple, http://myserver:8080/tfs/DefaultCollection). |
username |
Fournit une valeur pour l'option /user. Vous pouvez spécifier cet argument en tant que Domaine\NomUtilisateur ou NomUtilisateur. |
changesetnumber |
Identifie l'ensemble de modifications à examiner ou à modifier. Ne peut pas être utilisé avec /latest. |
Option |
Description |
|---|---|
/comment |
Remplace par un nouveau commentaire le commentaire d'ensemble de modifications créé au cours du processus d'archivage. |
/notes |
Fournit une ou plusieurs notes d'archivage à associer à l'ensemble de modifications. |
/latest |
Spécifie l'ensemble de modifications le plus récent. Ne peut pas être utilisé avec changesetnumber. |
/noprompt |
Supprime les invites de saisie. |
/collection |
Spécifie la collection du projet d'équipe. |
/login |
Spécifie le nom d'utilisateur et le mot de passe pour authentifier l'utilisateur avec Visual Studio Team Foundation Server. |
Notes
Un ensemble de modifications est un jeu de révisions de fichiers et de dossiers validées sur le serveur de contrôle de version Team Foundation dans le cadre d'un même événement d'archivage. Pour plus d'informations, consultez Utilisation d'ensembles de modifications.
Vous pouvez utiliser la commande changeset pour visualiser 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 History, commande.
Pour obtenir des liens vers d'autres commandes de Team Foundation qui fournissent des informations supplémentaires sur les éléments se trouvant sur votre serveur de contrôle de version Team Foundation et tous les espaces de travail qui correspondent à ce serveur, consultez Commandes d'information.
Pour plus d'informations sur la localisation de l'utilitaire en ligne de commande tf, consultez Commandes de l'utilitaire en ligne de commande Tf.
Exemples
L'exemple suivant affiche des informations détaillées sur l'ensemble de modifications 8675309 sous un format modifiable dans la boîte de dialogue Ensemble de modifications et remplace le commentaire existant par "Ceci est un nouveau commentaire".
Une fois que vous avez appuyé sur ENTRÉE, la boîte de dialogue Détails de l'ensemble de modifications <NuméroEnsembleDeModifications> - Fichiers sources apparaît. Cliquez sur Enregistrer pour associer le commentaire à l'ensemble de modifications.
c:\projects>tf changeset /comment:"This is a new comment." 8675309
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 comprenant 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
Le fichier notes.txt peut se présenter au format suivant :
field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;
L'exemple suivant remplace le commentaire existant sur l'ensemble de modifications 8675309 et affiche des informations sur l'ensemble de modifications dans la fenêtre d'invite de commandes. L'exemple ne lance pas la boîte de dialogue Ensemble de modifications.
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 Invite de commandes.
c:\projects>tf changeset 8675309 /noprompt
Résultat de l'exemple :
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 is not 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
Voir aussi
Référence
Concepts
Utilisation d'ensembles de modifications