Befehl "Einchecken"

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

Visual Studio 2019 | Visual Studio 2022

Der TFVC-checkin-Befehl überprüft ihre ausstehenden Datei- und Ordneränderungen am Server.

Fast jede Änderung, die Sie an den Dateien auf Ihrem Entwicklungscomputer vornehmen, wird in Ihrem Arbeitsbereich als ausstehende Änderung gespeichert, bis Sie sie einchecken. Wenn Sie Ihre Änderungen einchecken, werden sie als Changeset auf dem Server gespeichert. Der Befehl checkin bietet eine andere Benutzeroberfläche, um die gleichen Prozesse zu erledigen, die in Visual Studio dokumentiert sind, Einchecken Ihrer Arbeit an die Codebasis des Teams.

Tipps

• Verwenden Sie den Shelve Command, um Änderungen beiseite zu legen oder den Arbeitsbereich für eine andere Aufgabe zu bereinigen.

• Wenn Konflikte ihre Eincheckung blockieren, können Sie die Befehl auflösen verwenden, um sie zu beheben.

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

Voraussetzungen

• TFVC-Standardberechtigungen

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]

Die Parameter

Parameter

Beschreibung

---

/author:<author name>

Gibt den Autor der ausstehenden Änderungen an, damit ein Benutzer Änderungen im Namen eines anderen Benutzers einchecken kann.

Erfordert die berechtigung CheckinOther. Siehe Berechtigungs- und Gruppenreferenz.

/bypass

Umgeht eine gated Check-In-Anforderung. 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 Projektauflistung an, die das Regalet enthält. Beispiel: http://myserver:8080/tfs/DefaultCollection.

Standardmäßig wird davon ausgegangen, dass die Projektsammlung der Arbeitsbereich ist, der das aktuelle Verzeichnis zuordnet.

/comment

Ordnet einen Kommentar dem Changeset mithilfe eines der folgenden Argumente zu:

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

/force

Erzwingt ein Einchecken von Elementen mit ausstehenden Bearbeitungen, auch wenn keine Inhaltsänderungen in der Datei vorhanden sind.

<itemspec>

Gibt den Gültigkeitsbereich der Elemente an, die aus dem Arbeitsbereich des Benutzers eingecheckt werden sollen. Sie können mehrere itemspec Argumente angeben. Syntax finden Sie unter Verwenden von Steuerelementbefehlen für die Team Foundation-Version.

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

Gibt das Benutzerkonto an, mit dem der Befehl ausgeführt werden soll. Siehe Verwenden von Steuerelementbefehlen für die Team Foundation-Version.

/new

Der ausgewählte Zustand jeder ausstehenden Änderung, wie im Dialogfeld Einchecken dargestellt. Der Kommentar, zugeordnete Arbeitsaufgaben, Einchecknotizen und Eincheckrichtlinienüberschreibungsgrund werden auf Ihrem Entwicklungscomputer als ausstehende Änderungen gespeichert, bis Sie sie einchecken. Die Option /new deaktiviert diese Eincheckmetadaten, bevor Sie einchecken. Diese Option und das Verhalten, das geändert wird, haben keine Auswirkungen, wenn Sie die Option /noprompt verwenden.

/noautoresolve

Standardmäßig versucht das System automatisch, Konflikte zu AutoResolve All. Geben Sie diese Option an, um dieses Standardverhalten zu deaktivieren. Weitere Informationen finden Sie unter Beheben von Team Foundation-Versionssteuerungskonflikten.

/noprompt

Unterdrückt die Anzeige von Fenstern und Dialogfeldern, z. B. das Dialogfeld Einchecken, und leitet Ausgabedaten an die Eingabeaufforderung um. Siehe Verwenden von Steuerelementbefehlen für die Team Foundation-Version.

/notes

Stellt eine oder mehrere Check-In-Notizen bereit, die dem Changeset mithilfe eines der folgenden Argumente zugeordnet werden:

• <NoteFieldName>=<NoteFieldValue>: Legt den Wert des Check-In-Notizfelds fest. Sie können mehrere, durch Semikolons getrennte field=value Ausdrücke bereitstellen.
• @<NoteFile>: Der vom Benutzer bereitgestellte Pfad einer Datei auf dem Datenträger, die Feldnamen und Werte im Format von field=valueenthält. Eine durch Semikolons getrennte Notizkachel kann mehrere Linien umfassen, z. B.:
  
  <Field1>=<Value1>;
<Field2>=<First line of Value2>;
<Second line of Value2>;
<Field3>=<Value3>;

/override

Setzt eine Eincheckrichtlinie mit einem der folgenden Argumente außer Kraft:

• 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

Überprüft rekursiv Elemente im angegebenen Verzeichnis und alle Unterverzeichnisse.

/saved

Diesen Parameter ignorieren.

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

Gibt eine Regale an, die eingecheckt werden soll. Das optionale owner-Argument gibt ein Regalet an, das der aktuelle Benutzer nicht besitzt.

Hinweis

Nachdem Sie die Regale eingecheckt haben, löscht das System es.

/validate

Testet, ob die Überprüfung erfolgreich wäre, ohne die Dateien einzuchecken. Das System wertet Check-In-Richtlinien, Check-In-Notizen und Listet Konflikte auf.

Hinweis

Wenn Sie die Option /noprompt nicht angeben, müssen Sie die Schaltfläche Einchecken im Dialogfeld Einchecken aktivieren, um das Einchecken zu überprüfen. Nachdem Sie diese Schaltfläche ausgewählt haben, checkt das System die Dateien nicht ein.

Beispiele

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

Einchecken aller ausstehenden Änderungen im aktuellen Arbeitsbereich

Der folgende Befehl 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, zu aktivieren oder zu deaktivieren, einen Kommentar hinzuzufügen, Arbeitsaufgaben zuzuordnen und andere Aufgaben auszuführen, und wählen Sie dann die Schaltfläche Einchecken aus, wenn Sie bereit sind, den Vorgang fortzusetzen.

c:\code\SiteApp\Main>tf checkin

Alle ausstehenden Änderungen mit einem Kommentar einchecken

Im folgenden Beispiel werden alle ausstehenden Änderungen im aktuellen Arbeitsbereich überprüft und ein Kommentar bereitgestellt, der Ihren Teamkollegen 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" zu verwenden

Im folgenden Beispiel werden ausstehende Änderungen an program.csüberprüft. Das Dialogfeld Einchecken wird nicht angezeigt, und wenn Konflikte das Einchecken blockieren, zeigt das System das Konfliktfenster nicht an.

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