Befehl Checkin

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Mit dem checkin-Befehl von TFVC werden Ihre ausstehenden Datei- und Ordneränderungen auf dem Server eingecheckt.

Fast alle Änderungen, die Sie an den Dateien auf dem Entwicklungscomputer vornehmen, werden in Ihrem Arbeitsbereich als ausstehende Änderung gespeichert, bis Sie sie einchecken. Wenn Sie die Änderungen einchecken, werden diese als Changeset auf dem Server gespeichert. Mit dem checkin-Befehl wird eine andere Benutzeroberfläche bereitgestellt, allerdings führen Sie darin dieselben Prozesse wie die aus, die für Visual Studio unter Einchecken Ihrer Arbeit in die Codebasis des Teams dokumentiert sind.

Tipps

  • Verwenden Sie den Shelve-Befehl, um Änderungen zurückzustellen oder Ihren Arbeitsbereich für eine andere Aufgabe zu bereinigen.

  • Wenn der Eincheckvorgang durch Konflikte verhindert wird, können Sie diese mit dem Resolve-Befehl lösen.

  • Wenn ein Computer und ein Benutzerkonto nicht über einen Arbeitsbereich verfügen, der der Projektsammlung zugeordnet ist, die das Shelveset enthält, können Sie die Optionen /shelveset und /collection verwenden, um ein Shelveset einzuchecken.

Voraussetzungen

Syntax

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]

Parameter

Parameter

Beschreibung

/author:<author name>

Identifiziert den Autor der ausstehenden Änderungen, damit ein Benutzer Änderungen anstelle eines anderen Benutzers einchecken kann.

Erfordert die CheckinOther-Berechtigung. Weitere Informationen finden Sie unter Referenz zu Berechtigungen und Gruppen.

/bypass

Umgeht eine abgegrenzte Eincheckvorgangsanforderung. Weitere Informationen finden Sie unter Einchecken in einen Ordner, der von einem Gated-Check-In-Buildprozess gesteuert wird.

/collection:<ProjectCollectionUrl>

Wenn Sie die Option shelveset verwenden, gibt die Option /collection die URL der Projektsammlung an, die das Shelveset enthält. Beispiel: http://myserver:8080/tfs/DefaultCollection.

Standardmäßig wird davon ausgegangen, dass die Projektsammlung den Arbeitsbereich enthält, der dem aktuellen Verzeichnis zugeordnet ist.

/comment

Ordnet dem Changeset mit einem der folgenden Argumente einen Kommentar zu:

  • "<comment>": Ein vom Benutzer bereitgestellter Kommentar über den Eincheckvorgang.
  • @<comment file>: Der Pfad zu einer Datei auf dem Datenträger, die den Kommentar zum Eincheckvorgang enthält.

/force

Erzwingt einen Eincheckvorgang für Elemente mit ausstehenden Änderungen, auch wenn die Datei keine Inhaltsänderungen enthält.

<itemspec>

Gibt den Bereich der Elemente an, die aus dem Arbeitsbereich des Benutzers eingecheckt werden sollen. Sie können mehrere itemspec-Argumente angeben. Weitere Informationen zur Syntax finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

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

Gibt das Benutzerkonto an, unter dem der Befehl ausgeführt wird. Weitere Informationen finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/new

Der Auswahlzustand jeder ausstehenden Änderung, wie im Dialogfeld Einchecken dargestellt. Der Kommentar, die zugeordneten Arbeitselemente, die Eincheckhinweise und der Grund für das Überschreiben der Eincheckrichtlinie werden auf dem Entwicklungscomputer als ausstehende Änderungen gespeichert, bis Sie sie einchecken. Mit der Option /new werden diese Eincheck-Metadaten vor dem Einchecken gelöscht. Diese Option und das Verhalten, die sie ändert, haben keine Auswirkungen, wenn Sie die Option /noprompt verwenden.

/noautoresolve

Das System versucht standardmäßig, alle Konflikte automatisch zu lösen (AutoResolve All). Geben Sie diese Option an, um dieses Standardverhalten zu deaktivieren. Weitere Informationen finden Sie unter Lösen von Konflikten der Team Foundation-Versionskontrolle.

/noprompt

Unterdrückt die Anzeige von Fenstern und Dialogfeldern (z. B. des Dialogfelds Einchecken) und leitet Ausgabedaten an die Eingabeaufforderung um. Weitere Informationen finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/notes

Stellt einen oder mehrere Eincheckhinweise bereit, die dem Changeset mit einem der folgenden Argumente zugeordnet werden:

  • <NoteFieldName>=<NoteFieldValue>: Legt den Wert des Felds für den Eincheckhinweis fest. Sie können mehrere, durch Semikolons getrennte field=value-Ausdrücke angeben.
  • @<NoteFile>: Der vom Benutzer bereitgestellte Pfad zu einer Datei auf dem Datenträger, die die Feldnamen und -werte für den Eincheckhinweis im Format field=value enthält. Eine durch Semikolons getrennte Hinweiskachel kann mehrere Zeilen umfassen, beispielsweise:

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

/override

Überschreibt eine Eincheckrichtlinie mithilfe eines der folgenden Argumente:

  • reason: Ein vom Benutzer bereitgestellter Grund, warum die Eincheckrichtlinie ignoriert wird.
  • reasonfile: Der Pfad zu einer Datei, die eine vom Benutzer bereitgestellte Beschreibung des Grunds enthält, warum die Eincheckrichtlinie ignoriert wird.

/recursive

Checkt rekursiv alle Elemente im angegebenen Verzeichnis und in sämtlichen Unterverzeichnissen ein.

/saved

Diesen Parameter ignorieren.

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

Gibt ein Shelveset an, das eingecheckt werden soll. Mit dem optionalen owner-Argument wird ein Shelveset angegeben, das sich nicht im Besitz des aktuellen Benutzers befindet.

Hinweis

Das Shelveset wird vom System gelöscht, wenn Sie es eingecheckt haben.

/validate

Testet, ob der Eincheckvorgang erfolgreich sein wird, ohne die Dateien einzuchecken. Das System untersucht Eincheckrichtlinien und Eincheckhinweise und führt Konflikte auf.

Hinweis

Wenn Sie die Option /noprompt nicht angeben, müssen Sie die Schaltfläche Einchecken im Dialogfeld Einchecken auswählen, um den Eincheckvorgang zu bestätigen. Das System checkt die Dateien erst ein, nachdem Sie diese Schaltfläche ausgewählt haben.

Beispiele

In den folgenden Beispielen wird davon ausgegangen, dass c:\code\SiteApp\Main der Hauptordner ist, der der Projektsammlung im Arbeitsbereich des Benutzers zugeordnet ist.

Einchecken aller ausstehenden Änderungen im aktuellen Arbeitsbereich

Durch den folgenden Befehl wird das Dialogfeld Einchecken angezeigt, in dem alle ausstehenden Änderungen im aktuellen Arbeitsbereich angezeigt werden. Sie können das Dialogfeld Einchecken verwenden, um die ausstehenden Änderungen, die Sie einchecken möchten, auszuwählen oder zu löschen, einen Kommentar hinzuzufügen, Arbeitselemente zuzuordnen und weitere Aufgaben auszuführen. Wenn Sie fortfahren möchten, wählen Sie anschließend die Schaltfläche Einchecken aus.

c:\code\SiteApp\Main>tf checkin

Einchecken aller ausstehenden Änderungen mit einem Kommentar

Durch den folgenden Befehl werden alle ausstehenden Änderungen im aktuellen Arbeitsbereich eingecheckt und ein Kommentar bereitgestellt, der Teammitgliedern hilft, den Zweck Ihrer Änderungen zu verstehen.

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

Einchecken einer Änderung an einem einzelnen Element ohne das Dialogfeld "Einchecken"

Im folgenden Beispiel werden ausstehende Änderungen in program.cs eingecheckt. Das Dialogfeld Einchecken wird nicht angezeigt, und falls der Eincheckvorgang durch Konflikte verhindert wird, wird auch kein Fenster „Konflikte“ vom System eingeblendet.

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