Befehl Changeset

Aktualisiert: November 2007

Zeigt Informationen über Attribute an und ermöglicht deren Änderung. Dazu gehören Kommentare und Eincheckhinweise, die einem Changeset zugeordnet sind.

Erforderliche Berechtigungen

Um den changeset-Befehl verwenden zu können, muss für alle Dateien und Ordner des Changesets, deren vollständige Informationen angezeigt werden sollen, die Berechtigung Lesen auf Zulassen festgelegt sein. Die einem Changeset zugeordneten Hinweise und Kommentare können nur vom Ersteller des Changesets oder einem Benutzer geändert werden, der über die globale Berechtigung Änderungen anderer Benutzer überarbeitenr verfügt. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

tf changeset [/comment:comment|@commentfile] [/server:servername] 
[/notes:(“NoteFieldName”=”NoteFieldValue”|@notefile)] [/noprompt] 
[changesetnumber | /latest]

Parameter

Argument

Beschreibung

comment

Stellt einen Kommentar über das Einchecken bereit.

@commentfile

Gibt den Pfad zu einer Datei auf dem Datenträger an, die den für das Einchecken verwendeten Kommentar enthält.

servername

Der vom Benutzer angegebene Wert für die /server-Option. Beispiel: teamfoundation2.

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

Stellt den Pfad zu einer Datei auf dem Datenträger bereit, die die Feldnamen und -werte für den Eincheckhinweis im Format "Feld=Wert" auf jeweils einer Zeile enthält.

changesetnumber

Identifiziert das Changeset, das überprüft oder geändert werden soll. Kann nicht mit /latest verwendet werden.

Option

Beschreibung

/comment

Ersetzt den Changesetkommentar, der während des Eincheckvorgangs erstellt wurde, durch einen neuen Kommentar.

/server

Identifiziert den Team Foundation Server. Diese Option ist erforderlich, wenn der Befehl von einem Verzeichnis aufgerufen wird, das keinem Arbeitsbereich zugeordnet ist.

/notes

Stellt einen oder mehrere Eincheckhinweise bereit, die dem Changeset zugeordnet werden können.

/latest

Gibt das letzte Changeset an. Kann nicht mit changesetnumber verwendet werden.

/noprompt

Unterdrückt alle Eingabeaufforderungen.

Hinweise

Ein Changeset ist ein Satz von Datei- und Ordnerrevisionen, für die bei demselben Eincheckvorgang auf dem Server für die Team Foundation-Versionskontrolle ein Commit durchgeführt wurde. Weitere Informationen finden Sie unter Arbeiten mit Changesets der Versionskontrolle.

Sie können mit dem Befehl changeset die Attribute eines Changesets anzeigen und die zugehörigen Eigenschaften bearbeiten. Mithilfe des Befehls History können Sie das Changeset bestimmen, über das Sie Informationen benötigen. Weitere Informationen finden Sie unter Befehl History.

Links zu anderen Team Foundation-Befehlen, unter denen Sie weitere Informationen über die Elemente des Servers für die Team Foundation-Versionskontrolle und sämtliche zugeordneten Arbeitsbereiche erhalten, finden Sie unter Informationsbefehle.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".

Beispiele

Im folgenden Beispiel werden detaillierte Informationen über das Changeset 8675309 in einem bearbeitbaren Format im Dialogfeld Changeset angezeigt. Außerdem wird der vorhandene Kommentar durch "This is a new comment." ersetzt.

Nachdem Sie die EINGABETASTE gedrückt haben, wird das Dialogfeld Details für Changeset<changeset number>- Quelldateien angezeigt. Klicken Sie auf Speichern, um dem Changeset den Kommentar zuzuordnen.

c:\projects>tf changeset /comment:"This is a new comment." 8675309

Im folgenden Beispiel werden zwei Eincheckhinweise bereitgestellt, die dem Changeset zugeordnet werden sollen.

c:\projects>tf changeset /notes:reviewer=Jo; Security = checked 8675309

Im folgenden Beispiel werden zwei Eincheckhinweise bereitgestellt, deren Werte und Namen Leerzeichen enthalten und die dem Changeset zugeordnet werden sollen.

c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309

Im folgenden Beispiel werden die in der Datei notes.txt enthaltenen Eincheckhinweise des Changesets 8675309 zugeordnet.

c:\projects>tf changeset /notes:@notes.txt 8675309

Wobei notes.txt in folgendem Format vorliegen kann:

field1=value1;

field2=value that

spans multiple

lines;

field3 = value3;

Im folgenden Beispiel wird der vorhandene Kommentar für das Changeset 8675309 ersetzt, und im Eingabeaufforderungsfenster werden Informationen zum Changeset angezeigt. Im Beispiel wird das Dialogfeld Changeset nicht geöffnet.

c:\projects>tf changeset /comment:”This is an automatically generated comment.” /noprompt 8675309

Im folgenden Beispiel werden nicht bearbeitbare Informationen über das Changeset 8675309 in einem Eingabeaufforderungsfenster angezeigt.

c:\projects>tf changeset 8675309 /noprompt

Beispielausgabe:

Changeset: 8675309
User: DOMAIN\JohnG
Date: 01/21/2004 21:03:45
Comment:  This check-in fixes issues in several features.  I also refactored some items in buf.c into a new file named bif.c because buf.c was too hard to parse.
Items:
   $/baz/proj/bif.c           Added
   $/baz/proj/buf.c          Modified, Renamed
Work Items:
   34527     The "Access Denied" message is not descriptive enough.
   35628     The UI flickers when I press the '8', 'y', 'Ctrl', and 'End' buttons at the same time.
Check-in Notes:
   Code Reviewer:  ShellM
   Performance Reviewer: ShellM
   Security Reviewer: ShellM

Siehe auch

Konzepte

Arbeiten mit Changesets der Versionskontrolle

Referenz

Befehl Checkin

Befehle Checkout und Edit

Befehl Shelve

Befehl History

Befehl Configure

Weitere Ressourcen

Befehle des Befehlszeilendienstprogramms "Tf"