Befehl Checkin

  • Artikel

Checkt die ausstehenden Änderungen für Dateien oder Ordner auf dem Server ein.

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. Obwohl der Checkin-Befehl eine andere Benutzeroberfläche bereitstellt als die in Visual Studio verwendbare Oberfläche (siehe Einchecken von Arbeit in die Team-Codebase), ist der Prozess weitgehend identisch.

Anforderungen: Siehe Berechtigungsreferenz für Team Foundation Server.

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 Berechtigung CheckinOther. Siehe Berechtigungsreferenz für Team Foundation Server.

/bypass

Umgeht eine abgegrenzte Eincheckvorgangsanforderung. Weitere Informationen finden Sie unter Einchecken in einen Ordner, der von einem Buildprozess mit abgegrenztem Eincheckvorgang gesteuert wird.

/collection:TeamProjectCollectionUrl

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

Standardmäßig wird davon ausgegangen, dass die Teamprojektauflistung 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 vom Benutzer bereitgestellte Pfad zu einer Datei auf dem Datenträger, die den Kommentar für das Einchecken 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 mindestens ein Itemspec-Argument angeben. 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. Siehe Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/new

Der Auswahlzustand einer anstehenden Änderung (wie im Dialogfeld Einchecken angezeigt), der Kommentar, die zugeordneten Arbeitsaufgaben, 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 Metadaten für das Einchecken vor dem Einchecken gelöscht.

Diese Option und das Verhalten, die sie ändert, haben keine Auswirkungen, wenn Sie die Option /noprompt verwenden.

/noautoresolve

Standardmäßig versucht das System automatisch Alle automatisch auflösen (siehe Lösen von Konflikten der Team Foundation-Versionskontrolle). Geben Sie diese Option an, um dieses Standardverhalten zu deaktivieren.

/noprompt

Unterdrückt die Anzeige von Fenstern und Dialogfeldern (wie z. B. des Dialogfelds Einchecken) und leitet Ausgabedaten in die Eingabeaufforderung um. Siehe 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 Ausdrücke der Form "Feld=Wert" bereitstellen.

  • Notefile: Der vom Benutzer bereitgestellte Pfad zu einer Datei auf dem Datenträger, die die Feldnamen und -werte für den Eincheckhinweis im Format "Feld=Wert" in jeweils einer Zeile enthält. Eine durch Semikolons getrennte Hinweiskachel kann mehrere Zeilen umfassen, beispielsweise:

    Feld1=Wert1;

    Feld2=Erste Zeile von Wert2

    Zweite Zeile Wert 2;

    Feld3 = Wert3;

/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 festgelegt, 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, wenn Sie diese Schaltfläche ausgewählt haben.

Beispiele

Einchecken aller ausstehenden Änderungen im aktuellen Arbeitsbereich

c:\code\SiteApp\Main>tf checkin

Zeigt das Dialogfeld Einchecken an, 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, Arbeitsaufgaben zuzuordnen und weitere Aufgaben auszuführen und die Schaltfläche Einchecken auszuwählen, wenn Sie fortzufahren möchten.

Einchecken aller ausstehenden Änderungen mit einem Kommentar

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

Checkt alle ausstehenden Änderungen im aktuellen Arbeitsbereich ein und stellt einen Kommentar bereit, der Teammitgliedern hilft, den Zweck der Änderungen zu verstehen.

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

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

Checkt die ausstehenden Änderungen in program.cs ein. Das Dialogfeld Einchecken wird nicht angezeigt, und falls der Eincheckvorgang durch Konflikte blockiert wird, zeigt das System das Konfliktfenster nicht an.

Arbeiten in Visual Studio

Tipps

  • Tipp Wenn Sie Änderungen zurückstellen und möglicherweise auch den Arbeitsbereich für eine andere Aufgabe bereinigen möchten, verwenden Sie Befehl Shelve.

  • Tipp Wenn Konflikte den Eincheckvorgang blockieren, verwenden Sie Resolve Command, um sie zu lösen.

  • Tipp Wenn der Teamprojektauflistung eines Computers oder Benutzerkontos, die das Shelveset enthält, kein Arbeitsbereich zugeordnet ist, können Sie die Optionen /shelveset und /collection verwenden, um ein Shelveset einzuchecken.