Befehl Changeset
Zeigt Informationen über Attribute an und ermöglicht deren Änderung. Dazu gehören Kommentare und Eincheckhinweise, die einer Differenzmenge zugeordnet sind.
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 die Differenzmenge, die überprüft oder geändert werden soll. Kann nicht mit /latest verwendet werden. |
| Option | Beschreibung |
|---|---|
/comment |
Ersetzt den Differenzmengenkommentar, 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 der Differenzmenge zugeordnet werden können. |
/latest |
Gibt die letzte Differenzmenge an. Kann nicht mit changesetnumber verwendet werden. |
/noprompt |
Unterdrückt alle Eingabeaufforderungen. |
Hinweise
Eine Differenzmenge ist ein Satz von Datei- und Ordnerrevisionen, für die bei demselben Eincheckvorgang auf dem Server für die Quellcodeverwaltung in Team Foundation ein Commit durchgeführt wurde. Weitere Informationen finden Sie unter Arbeiten mit Differenzmengen der Quellcodeverwaltung.
Sie können mit dem Befehl changeset die Attribute einer Differenzmenge anzeigen und ihre veränderlichen Eigenschaften bearbeiten. Mithilfe des Befehls History können Sie die Differenzmenge bestimmen, über die 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 Quellcodeverwaltung in Team Foundation und sämtliche zugeordneten Arbeitsbereiche erhalten, finden Sie unter Informationsbefehle.
Beispiele
Im folgenden Beispiel werden detaillierte Informationen über die Differenzmenge 8675309 in einem bearbeitbaren Format im Dialogfeld Differenzmenge angezeigt. Außerdem wird der vorhandene Kommentar durch "This is a new comment." ersetzt.
c:\projects>tf changeset /comment:"This is a new comment." 8675309
Im folgenden Beispiel werden zwei Eincheckhinweise bereitgestellt, die der Differenzmenge 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 der Differenzmenge 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 der Differenzmenge 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 die Differenzmenge 8675309 ersetzt, und es werden nicht bearbeitbare Informationen über die Differenzmenge in einem Eingabeaufforderungsfenster angezeigt. Im Beispiel wird das Dialogfeld Differenzmenge nicht geöffnet.
c:\projects>tf changeset /comment:”This is an automatically generated comment.” /noprompt 8675309
Im folgenden Beispiel werden nicht bearbeitbare Informationen über die Differenzmenge 8675309 in einem Eingabeaufforderungsfenster angezeigt.
c:\projects>tf changeset 8675309 /noprompt
Beispielausgabe:
Changeset: 8675309
User: DOMAIN\JohnG
Date/time: 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.
Files:
$/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
Localization Impact (yes or no): no
UI/UE Change (yes or no): no
Sicherheit
Um den changeset-Befehl verwenden zu können, muss für alle Dateien und Ordner der Differenzmenge, deren vollständige Informationen angezeigt werden sollen, die Berechtigung Lesen auf Zulassen festgelegt sein. Die einer Differenzmenge zugeordneten Hinweise und Kommentare können nur vom Ersteller der Differenzmenge oder einem Benutzer geändert werden, der über die globale Berechtigung Änderungen anderer Benutzer überarbeiten verfügt. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
Siehe auch
Referenz
Befehl Checkin
Befehle Check-out und Edit
Befehl Shelve
Befehl History
Befehl Configure
Konzepte
Arbeiten mit Differenzmengen der Quellcodeverwaltung