Partager via


Commande Checkin

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

Visual Studio 2019 | Visual Studio 2022

La commande TFVC checkin vérifie dans votre fichier et dossier en attente les modifications apportées au serveur.

Presque toutes les modifications que vous apportez aux fichiers sur votre ordinateur de développement sont stockées dans votre espace de travail sous la forme d’un en attente de modification jusqu’à ce que vous l’archivez. Lorsque vous archivez vos modifications, elles sont stockées en tant qu’ensemble de modifications sur le serveur. La commande checkin fournit une interface utilisateur différente pour effectuer les mêmes processus documentés pour Visual Studio dans Vérifier votre travail dans la base de code de l’équipe.

Conseils

  • Pour mettre de côté les modifications ou nettoyer votre espace de travail pour une autre tâche, utilisez la commande Shelve.

  • Si des conflits bloquent votre archivage, vous pouvez utiliser la Résoudre la commande pour les résoudre.

  • Si un ordinateur et un compte d’utilisateur n’ont pas d’espace de travail mappé à la collection de projets qui contient le jeu d’étagères, vous pouvez utiliser les options /shelveset et /collection pour archiver un ensemble de rayons.

Conditions préalables

Syntaxe

tf checkin [/author:author name] [/comment:("comment"|@comment file)] 
[/noprompt] [/notes:("Note Name"="note text"|@notefile)] 
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/force] [/noautoresolve] [/login:username,[password]] [/new]
tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]

Paramètres

Paramètre

Description


/author:<author name>

Identifie l’auteur des modifications en attente afin qu’un utilisateur puisse archiver les modifications au nom d’un autre utilisateur.

Nécessite l’autorisation CheckinOther. Consultez informations de référence sur les autorisations et les groupes.

/bypass

Contourne une exigence de contrôle contrôlée. Pour plus d’informations, consultez Archiver dans un dossier contrôlé par un processus de création d’archivage contrôlé.

/collection:<ProjectCollectionUrl>

Si vous utilisez l’option shelveset, l’option /collection spécifie l’URL de la collection de projets qui contient le jeu d’étagères. Par exemple : http://myserver:8080/tfs/DefaultCollection.

Par défaut, la collection de projets est supposée être celle qui contient l’espace de travail qui mappe le répertoire actif.

/comment

Associe un commentaire au jeu de modifications à l’aide de l’un des arguments suivants :

  • "<comment>": commentaire fourni par l’utilisateur sur l’archivage.
  • @<comment file>: chemin d’accès à un fichier sur le disque qui contient le commentaire de l’archivage.

/force

Force un archivage sur les éléments avec des modifications en attente, même s’il n’y a aucune modification de contenu dans le fichier.

<itemspec>

Spécifie l’étendue des éléments à archiver à partir de l’espace de travail de l’utilisateur. Vous pouvez spécifier plusieurs arguments itemspec. Pour obtenir la syntaxe, consultez Utiliser les commandes de contrôle de version Team Foundation.

/login:<username>[,<password>]

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

/new

État sélectionné de chaque modification en attente, comme indiqué dans la boîte de dialogue Archiver. Le commentaire, les éléments de travail associés, les notes d’archivage et la raison de remplacement de la stratégie d’archivage sont stockés sur votre ordinateur de développement comme modifications en attente jusqu’à ce que vous les archivez. L’option /new efface ces métadonnées d’archivage avant de vous archiver. Cette option et le comportement qu’il modifie n’ont aucun effet lorsque vous utilisez l’option /noprompt.

/noautoresolve

Par défaut, le système tente automatiquement de AutoResolve All conflits. Spécifiez cette option pour désactiver ce comportement par défaut. Pour plus d’informations, consultez Résoudre les conflits Team Foundation Version Control.

/noprompt

Supprime l’affichage des fenêtres et des boîtes de dialogue, telles que la boîte de dialogue Archiver, et redirige les données de sortie vers l’invite de commandes. Consultez Utiliser les commandes de contrôle de version Team Foundation.

/notes

Fournit une ou plusieurs notes d’archivage à associer au jeu de modifications à l’aide de l’un des arguments suivants :

  • <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>: chemin d’accès fourni par l’utilisateur d’un fichier sur le disque qui contient des noms et des valeurs de champ de note d’archivage au format de field=value. Une vignette de note séparée par des points-virgules peut s’étendre sur plusieurs lignes, par exemple :

    <Field1>=<Value1>;
    <Field2>=<First line of Value2>;
    <Second line of Value2>;
    <Field3>=<Value3>;

/override

Remplace une stratégie d’archivage à l’aide de l’un des arguments suivants :

  • reason: raison pour laquelle la stratégie d’archivage est ignorée.
  • reasonfile: chemin d’accès à un fichier qui contient une description fournie par l’utilisateur de la raison pour laquelle la stratégie d’archivage est ignorée.

/recursive

Vérifie de manière récursive les éléments dans le répertoire spécifié et les sous-répertoires spécifiés.

/saved

Ignorez ce paramètre.

/shelveset:<shelvesetname>[;<owner>]

Spécifie un ensemble de rayons à archiver. L’argument facultatif owner spécifie un ensemble de rayons que l’utilisateur actuel ne possède pas.

Remarque

Après avoir vérifié l’ensemble de rayons, le système le supprime.

/validate

Teste si l’archivage réussit, sans archiver les fichiers. Le système évalue les stratégies d’archivage, les notes d’archivage et répertorie les conflits.

Remarque

Si vous ne spécifiez pas l’option de /noprompt, vous devez sélectionner le bouton Archiver dans la boîte de dialogue Archiver pour valider l’archivage. Après avoir sélectionné ce bouton, le système n’archive pas les fichiers.

Exemples

Les exemples suivants supposent que c:\code\SiteApp\Main est le dossier principal mappé à la collection de projets dans l’espace de travail de l’utilisateur.

Vérifier toutes les modifications en attente dans l’espace de travail actuel

La commande suivante affiche la boîte de dialogue Archiver, qui affiche toutes les modifications en attente dans l’espace de travail actuel. Vous pouvez utiliser la boîte de dialogue Archiver pour activer ou effacer les modifications en attente que vous souhaitez archiver, ajouter un commentaire, associer des éléments de travail et effectuer d’autres tâches, puis choisir le bouton Archiver lorsque vous êtes prêt à continuer.

c:\code\SiteApp\Main>tf checkin

Vérifier toutes les modifications en attente avec un commentaire

L’exemple suivant vérifie toutes les modifications en attente dans l’espace de travail actuel et fournit un commentaire pour aider vos collègues à comprendre l’objectif de vos modifications.

c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"

Archiver une modification d’un seul élément sans utiliser la boîte de dialogue Archiver

L’exemple suivant vérifie les modifications en attente de program.cs. La boîte de dialogue Archiver n’est pas affichée et, si des conflits bloquent l’archivage, le système n’affiche pas la fenêtre de conflits.

c:\code\SiteApp\Main>tf checkin program.cs /noprompt