Befehl Checkin

Artikel
08/20/2007

Führt einen Commit für die im aktuellen Arbeitsbereich ausstehenden Änderungen auf dem Server für die Quellcodeverwaltung in Team Foundation aus.

tf checkin [/author:author name] [/comment:("comment"|@comment file)] 
[/noprompt] [/notes:(“Note Name”=”note text”|@notefile)] 
[/override:reasonfile|@reason] [/recursive] [/saved] [/validate] 
[filespec]

Parameter

Argument	Beschreibung
authorname	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.
Filespec	Gibt eine Datei oder einen Ordner für das Einchecken an. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Dateispezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen.

Option	Beschreibung
/author	Identifiziert den Autor der angegebenen oder impliziten ausstehenden Änderungen, damit ein Benutzer Änderungen anstelle eines anderen Benutzers einchecken kann. Erfordert die CheckinOther-Berechtigung.
/comment	Ordnet der Differenzmenge einen Kommentar zu.
/noprompt	Unterdrückt alle Eingabeaufforderungen.
/notes	Stellt einen oder mehrere Eincheckhinweise bereit, die der Differenzmenge 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	Diese Option enthält keine Argumente. 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 den Kommentaren and allen anderen gespeicherten Informationen ein, sofern diese vorhanden sind.
/validate	Mit der Option /validate können Sie das Einchecken testen, ohne diesen Vorgang tatsächlich auszuführen. Mit der Option /validate werden beim Einchecken die Eincheckrichtlinien und Eincheckhinweise ausgewertet. Außerdem werden Konflikte ermittelt, ohne dass tatsächlich ein Eincheckvorgang durchgeführt wird. Dadurch können Probleme und Konflikte gelöst werden.

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 wurde noch nicht für das Einchecken übermittelt. Weitere Informationen über ausstehende Änderungen sowie eine vollständige Liste der ausstehenden Änderungen in Team Foundation finden Sie unter Ausstehende Änderungen.

Mit dem Befehl checkin wird auf dem Server für die Quellcodeverwaltung in Team Foundation eine Differenzmenge 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 Differenzmengen für die von Ihnen übermittelten Änderungen an.

Hinweis

Da ausstehende Änderungen über die Befehlszeile eingecheckt werden können, besteht die Möglichkeit, dass das Kontextmenü vom Quellcodeverwaltungs-Explorer nicht immer mit dem Status der ausstehenden Änderungen synchronisiert ist.

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 Quellcodeverwaltung in Team Foundation übermittelt werden kann, wird für keine der Änderungen ein Commit durchgeführt und keine Differenzmenge 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 Quellcodeverwaltung in Team Foundation beibehalten und zu einem Attribut der Differenzmenge nach dem Commit. Die Option /override ist hauptsächlich für die Verwendung in Skripts vorgesehen. Weitere Informationen finden Sie unter Gewusst wie: Überschreiben einer Eincheckrichtlinie.

Wenn sich die Basisversion eines Elements in der Liste ausstehender Änderungen von der letzten Version auf dem Server für die Quellcodeverwaltung in Team Foundation 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 Quellcodeverwaltung in Team Foundation auf. Wenn Sie z. B. Version 4 von stellar.cs ausgecheckt haben und die letzte Version auf dem Server für die Quellcodeverwaltung in Team Foundation 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 eine ausstehende Differenzmenge auf dem Server für die Quellcodeverwaltung in Team Foundation übermittelt. Anschließend wird überprüft, ob die Version auf dem Server für die Quellcodeverwaltung in Team Foundation seit dem Auschecken des Elements nicht verändert wurde. Wenn das Einchecken erfolgreich ist, erstellt Team Foundation eine Differenzmenge 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 Quellcodeverwaltung in Team Foundation übermittelt, um eine neue Differenzmenge 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

Sicherheit

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 finden Sie unter Team Foundation Server-Berechtigungen.

Siehe auch

Freigeben über

Befehl Checkin

Parameter

Hinweise

Der Eincheckvorgang

Beispiele

Sicherheit

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen