Befehl Changeset
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 hierzu finden Sie unter Team Foundation Server-Berechtigungen.
tf changeset [/comment:("comment"|@commentfile)]
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]]
[changesetnumber | /latest][/login:username,[password]]
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. |
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. |
TeamProjectCollectionUrl |
Die URL der Teamprojektauflistung, die ein Changeset enthält, zu dem Sie Informationen anzeigen möchten oder dessen Attribute Sie ändern möchten (z. B. http://myserver:8080/tfs/DefaultCollection). |
username |
Gibt einen Wert für die /user-Option an. Sie können dieses Argument als Domäne\Benutzername oder als Benutzername angeben. |
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. |
/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. |
/collection |
Gibt die Teamprojektsammlung an. |
/login |
Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Visual Studio Team Foundation Server an. |
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.
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 Befehlszeilenhilfsprogramms "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