Befehl Checkin
Führt einen Commit für die im aktuellen Arbeitsbereich ausstehenden Änderungen auf dem Server für die Team Foundation-Versionskontrolle aus.
Erforderliche Berechtigungen
Damit Sie den Befehl checkin verwenden können, muss die Berechtigung Einchecken auf Zulassen festgelegt sein. Um die /author-Option zu verwenden, muss die Berechtigung Änderungen anderer Benutzer einchecken ebenfalls auf Zulassen festgelegt sein. Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.
tf checkin [/author:author name] [/comment:("comment"|@comment file)]
[/noprompt] [/notes:("Note Name"="note text"|@notefile)]
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/login:username,[password]]
tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]
Parameter
Argument |
Beschreibungen |
|---|---|
author name |
Der vom Benutzer angegebene Wert für die /author-Option. |
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. |
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" enthält. Eine durch Semikolons getrennte Hinweisdatei kann mehrere Zeilen umfassen, zum Beispiel: feld1=wert1; feld2=wert der mehrere Zeilen umfasst;. |
Reasonfile |
Eine vom Benutzer bereitgestellte Beschreibung des Grunds für das Ignorieren der Eincheckrichtlinie. Wenn ein Grund angegeben wird, wird den Team Foundation-Administratoren per E-Mail eine Benachrichtigung über das Umgehen der Richtlinien und diese Erklärung gesendet. |
itemspec |
Gibt eine Datei oder einen Ordner zum Einchecken an. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Dateispezifikation die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen. |
username |
Gibt einen Wert für die /login-Option an. Sie können als Wert für einen Benutzernamen entweder DOMÄNE\Benutzername oder Benutzername angeben. |
shelvesetname [:owner] |
Identifiziert das Shelveset, das Sie einchecken möchten. Mit dem optionalen owner-Argument wird ein Shelveset festgelegt, das sich nicht im Besitz des aktuellen Benutzers befindet. |
TeamProjectCollectionUrl |
Die URL der Teamprojektauflistung, die die Dateien oder Ordner enthält, die Sie einchecken möchten (z. B. http://myserver:8080/tfs/DefaultCollection). |
Option |
Beschreibungen |
|---|---|
/author |
Identifiziert den Autor der ausstehenden Änderungen, damit ein Benutzer Änderungen anstelle eines anderen Benutzers einchecken kann. Erfordert die CheckinOther-Berechtigung. |
/comment |
Ordnet dem Changeset einen Kommentar zu. |
/noprompt |
Unterdrückt alle Eingabeaufforderungen. |
/notes |
Stellt einen oder mehrere Eincheckhinweise bereit, die dem Changeset zugeordnet werden können. |
/override |
Ermöglicht Ihnen das Überschreiben von Eincheckrichtlinien. Diese Option ist nur dann erforderlich, wenn Sie trotz einer Eincheckrichtlinie einen Eincheckvorgang durchführen möchten. |
/recursive |
Checkt alle Elemente im angegeben oder impliziten Arbeitsordner sowie in den Unterordnern ein. |
/saved |
Wenn das Einchecken fehlschlägt oder vom Benutzer abgebrochen wird oder wenn der Benutzer die Änderungen aufnimmt, werden die ausgewählten Änderungen, Kommentare, Arbeitsaufgaben, Eincheckhinweise und ggf. die Gründe für das Überschreiben von Richtlinien auf dem Computer gespeichert. Bei Verwendung mit /noprompt checkt die Option /saved die Änderungen mit dem Kommentar usw. ein. die gespeichert wurden (sofern vorhanden). |
/validate |
Mit der Option /validate können Sie das Einchecken testen, ohne diesen Vorgang tatsächlich auszuführen. Die /validate-Optionen bewirken die Auswertung von Eincheckrichtlinien, die Überprüfung von Eincheckhinweisen und die Suche nach Konflikten ohne tatsächliches Einchecken. Alle Probleme, z. B. Konflikte, die von dieser Option identifiziert werden, müssen gelöst werden, bevor Sie das Element einchecken. |
/bypass |
Umgeht eine abgegrenzte Eincheckvorgangsanforderung. Weitere Informationen finden Sie unter Einchecken ausstehender Änderungen für einen abgegrenzten Eincheckbuild. |
/login |
Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an. |
/shelveset |
Gibt das Shelveset mit Namen an. |
/collection |
Gibt die Teamprojektsammlung an. |
Hinweise
Eine ausstehende Änderung umfasst das Hinzufügen, Löschen, Umbenennen, Bearbeiten, Verzweigen und Wiederherstellen von Dateien und Ordnern sowie filetype. Einige Änderungen, z. B. das Bearbeiten und Umbenennen, können gleichzeitig auf ein Element angewendet werden. Eine ausstehende Änderung ist eine, die nicht zum Einchecken gesendet wurde. Weitere Informationen und eine vollständige Liste von ausstehenden Änderungen in Team Foundation finden Sie unter Ausstehende Änderungen.
Mit dem Befehl checkin wird auf dem Server für die Team Foundation-Versionskontrolle ein Changeset aus einer dynamisch definierten Reihe ausstehender Änderungen, Arbeitsaufgaben, benutzerdefinierten Kommentaren und Systemmetadaten erstellt. Außerdem werden die Änderungen für andere Benutzer verfügbar gemacht. Andere Benutzer können die Änderungen mit dem Befehl get abrufen. Mit den Befehlen history und changeset zeigen Sie Informationen aus Changesets für die von Ihnen übermittelten Änderungen an.
Tipp
Da Sie ausstehende Änderungen in der Befehlszeile einchecken können, reflektiert das Kontextmenü Quellcodeverwaltungs-Explorer möglicherweise nicht immer den Status von den ausstehenden Änderungen.
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".
Der Eincheckvorgang
Der Eincheckvorgang wird atomar ausgeführt. Das bedeutet, dass der Vorgang entweder vollständig erfolgreich durchgeführt wird oder vollständig fehlschlägt. Wenn eine der Änderungen in der Liste der ausstehenden Änderungen nicht auf den Server für die Team Foundation-Versionskontrolle übermittelt werden kann, wird für keine der Änderungen ein Commit durchgeführt und kein Changeset erstellt. Wenn z. B. während des Vorgangs die Netzwerkverbindung ausfällt, schlägt der gesamte Vorgang fehl.
Der erste Schritt beim Eincheckvorgang ist das Auswerten der ausstehenden Änderungen in Bezug auf die Einhaltung der Eincheckrichtlinien. Sie können Eincheckrichtlinien in der Befehlszeile mit der Option /override überschreiben. Sie müssen einen Grund für das Überschreiben der Richtlinien angeben. Dieser Grund wird auf dem Server für die Team Foundation-Versionskontrolle beibehalten und zu einem Attribut der Changesets nach dem Commit. Die Option /override ist hauptsächlich für die Verwendung in Skripts vorgesehen. Weitere Informationen finden Sie unter Überschreiben einer Eincheckrichtlinie.
Wenn sich eine Version eines Elements in der Liste ausstehender Änderungen von der letzten Version auf dem Server für die Team Foundation-Versionskontrolle unterscheidet, fordert Sie Team Foundation zunächst zum Auflösen von Konflikten zwischen Ihrer Version und der letzten Version auf dem Server für die Team Foundation-Versionskontrolle auf. Wenn Sie z. B. Version 4 von stellar.cs ausgecheckt haben und die letzte Version auf dem Server für die Team Foundation-Versionskontrolle Version 6 ist, werden Sie zum Auflösen der Konflikte aufgefordert. Wenn die Option **/noprompt **angegeben wird, wird das Dialogfeld Auflösen angezeigt, in dem Sie Versionsunterschiede ermitteln und auflösen können. Nachdem Sie die Unterschiede aufgelöst und den Code getestet haben, können Sie erneut versuchen, die Änderungen einzuchecken.
Beispiele
Im folgenden Beispiel wird das Dialogfeld Einchecken angezeigt, in dem bereits ausstehende Änderungen ausgewählt wurden, die in einem Sammelvorgang mit allen ausstehenden Änderungen im Arbeitsbereich eingecheckt werden sollen, der c:\projects zugeordnet ist. Wenn Sie auf Einchecken klicken, werden die Elemente einzeln an ein Changeset auf dem Server für die Team Foundation-Versionskontrolle übermittelt. Anschließend wird überprüft, ob die Version auf dem Server seit dem Auschecken des Elements nicht verändert wurde. Wenn das Einchecken erfolgreich ist, erstellt Team Foundation ein Changeset und zeigt deren Nummer für spätere Verweise an.
c:\projects>tf checkin
Im folgenden Beispiel werden alle ausstehenden Änderungen im aktuellen Arbeitsbereich zusammen mit dem angegebenen Kommentar auf den Server für die Team Foundation-Versionskontrolle übermittelt, um ein neues Changeset zu erstellen.
c:\projects>tf checkin /comment:"Re-implemented Pi calculator" /noprompt
Im folgenden Beispiel werden die ausstehenden Änderungen an 314.cs übermittelt, wobei alle Revisionen im aktuellen Arbeitsbereich als ausstehend beibehalten werden.
c:\projects>tf checkin 314.cs /noprompt
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Anpassen von Eincheckrichtlinien und -hinweisen
Einchecken von ausstehenden Änderungen
Referenz
Befehlszeilensyntax (Versionskontrolle)