Freigeben über

Befehl 'Changeset'

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022-

Zeigt Informationen zu und ermöglicht es Ihnen, die Attribute, z. B. Kommentare und Einchecken von Notizen, zu ändern, die einem Changeet zugeordnet sind.

Voraussetzungen

Um den Befehl changeset zu verwenden, müssen Sie die Berechtigung Lesen auf Zulassen für alle Dateien oder Ordner in der Änderungsgruppe festlegen, für die Sie vollständige Informationen anzeigen möchten. Die einzigen Benutzer, die die Notizen und Kommentare ändern können, die einem Changeset zugeordnet sind, sind die Benutzer, die das Changeset erstellt haben, oder ein Benutzer, der über die Änderungen Änderungen anderer Benutzer globalen Berechtigung verfügt.

Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.

Syntax

tf changeset [/comment:("comment"|@commentfile)] 
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]] 
[changesetnumber | /latest][/login:username,[password]]

Parameter

Argument

Argument Beschreibung
comment Stellt einen Kommentar zum Einchecken bereit.
@<commentfile> Gibt einen Pfad einer Datei auf dem Datenträger an, die den für die Überprüfung verwendeten Kommentar enthält.
<NoteFieldName>=<NoteFieldValue> Legt den Wert des Check-In-Notizfelds fest. Sie können mehrere, durch Semikolons getrennte field=value Ausdrücke bereitstellen.
@<notefile> Stellt den Pfad einer Datei auf dem Datenträger bereit, die Die Namen und Werte des Check-In-Notizfelds im Format von field=value mit einer pro Zeile enthält.
<TeamProjectCollectionUrl> Die URL der Projektauflistung, die einen Änderungssatz enthält, zu dem Informationen angezeigt werden sollen oder deren Attribute Sie ändern möchten, z. B. http://myserver:8080/tfs/DefaultCollection.
<username> Stellt einen Wert für die Option /user bereit. Sie können dieses Argument entweder als Domain\username oder als usernameangeben.
<changesetnumber> Gibt den zu überprüfenden oder geänderten Änderungssatz an. Kann nicht mit /latestverwendet werden.

Option

Option Beschreibung
/comment Ersetzt den Changeset-Kommentar, der während des Eincheckens erstellt wurde, durch einen neuen Kommentar.
/notes Stellt eine oder mehrere Check-In-Notizen bereit, die dem Changeset zugeordnet werden sollen.
/latest Gibt das letzte Änderungsset an. Kann nicht mit <changesetnumber>verwendet werden.
/noprompt Unterdrückt alle Aufforderungen zur Eingabe von Ihnen.
/collection Gibt die Projektauflistung an.
/login Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.

Bemerkungen

Ein Changeset ist eine Reihe von Datei- und Ordnerrevisionen, die im Rahmen desselben Check-In-Ereignisses auf den Team Foundation-Versionssteuerungsserver übernommen wurden. Weitere Informationen finden Sie unter Arbeiten mit Changesets.

Sie können den Befehl changeset verwenden, um die Attribute eines Changesets anzuzeigen und dessen Eigenschaften zu ändern. Sie können den Befehl history verwenden, um zu bestimmen, zu welchem Changeet Sie Informationen erhalten möchten. Weitere Informationen finden Sie unter Verlaufsbefehl.

Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.

Beispiele

Im folgenden Beispiel werden detaillierte Informationen zum Changeset-8675309 in einem bearbeitbaren Format im Visual Studio Details für Changeset 8675309 - Quelldateien Dialogfeld angezeigt und der vorhandene Kommentar durch Ersetzt. Dies ist ein neuer Kommentar.

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

Nachdem Sie den Befehl eingegeben haben, wählen Sie im Dialogfeld "Visual Studio Details zu Changeset 8675309 – Quelldateien" Speichern aus, um den Kommentar dem Changeset zuzuordnen.

Im folgenden Beispiel werden zwei Check-In-Notizen bereitgestellt, die dem Changeset zugeordnet werden sollen.

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

Im folgenden Beispiel werden zwei Check-In-Notizen bereitgestellt, die Leerzeichen in den Werten und Namen enthalten, 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 enthaltenen Check-In-Notizen notes.txt dem Changeset-8675309 zugeordnet.

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

Wo sich die notes.txt im folgenden Format befinden kann:

field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;

Im folgenden Beispiel wird der vorhandene Kommentar für änderungenet 8675309 ersetzt und Informationen zum Changeset im Eingabeaufforderungsfenster angezeigt. In diesem Beispiel wird das Dialogfeld "Visual Studio Changeset" nicht geöffnet.

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

Im folgenden Beispiel werden nicht bearbeitbare Informationen zu Changeset-8675309 im 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 isn't 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