Changeset-Befehl

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Zeigt Informationen zum Befehl an und ermöglicht Ihnen das Ändern der Attribute, z. B. Kommentare und Einchecknotizen, die einem Changeset zugeordnet sind.

Voraussetzungen

Damit Sie den changeset-Befehl verwenden können, müssen Sie die Berechtigung Lesen für alle Dateien oder Ordner im Changeset, für die Sie vollständige Informationen anzeigen möchten, auf Zulassen festgelegt haben. 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 globale Berechtigung Änderungen anderer Benutzer überarbeiten verfügt.

Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

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 zu einer Datei auf dem Datenträger an, die den Kommentar für das Einchecken enthält.
<NoteFieldName>=<NoteFieldValue> Legt den Wert des Felds für den Eincheckhinweis fest. Sie können mehrere, durch Semikolons getrennte field=value-Ausdrücke angeben.
@<notefile> Gibt den Pfad zu einer Datei auf dem Datenträger an, die die Feldnamen und -werte für den Eincheckhinweis im Format field=value in jeweils einer Zeile enthält.
<TeamProjectCollectionUrl> Die URL der Projektauflistung, die ein Changeset enthält, über das Sie Informationen anzeigen möchten oder dessen 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 username angeben.
<changesetnumber> Gibt das Changeset an, das überprüft oder geändert werden soll. Kann nicht mit "/latest" verwendet werden.

Option

Option Beschreibung
/comment Ersetzt den Changeset-Kommentar, der während des Eincheckvorgangs erstellt wurde, durch einen neuen Kommentar.
/notes Stellt einen oder mehrere Eincheckhinweise bereit, die dem Changeset zugeordnet werden.
/latest Gibt das aktuellste Changeset an. Kann nicht mit "<changesetnumber>" verwendet werden.
/noprompt Unterdrückt alle Aufforderungen zu einer Eingabe durch Sie.
/collection Gibt die Projektsammlung an.
/login Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.

Hinweise

Ein Changeset ist eine Gruppe von Datei- und Ordnerrevisionen, die im Rahmen desselben Eincheckereignisses an den Team Foundation-Versionskontrollserver committet wurden. Weitere Informationen finden Sie unter Arbeiten mit Changesets.

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

Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Beispiele

Im folgenden Beispiel werden ausführliche Informationen zu Changeset 8675309 in einem bearbeitbaren Format im Visual Studio-Dialogfeld Details zu Changeset 8675309 – Quelldateien angezeigt, und der vorhandene Kommentar wird durch Dies ist ein neuer Kommentar ersetzt.

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

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

Im folgenden Beispiel werden zwei Einchecknotizen bereitgestellt, die dem Changeset zugeordnet werden können.

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

Das folgende Beispiel enthält zwei Eincheckhinweise, 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 notes.txt enthaltenen Eincheckhinweise dem Changeset-8675309 zugeordnet.

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

Dabei kann notes.txt das folgende Format aufweisen:

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

Im folgenden Beispiel wird der vorhandene Kommentar zu Changeset 8675309 ersetzt, und es werden Informationen zum Changeset im Eingabeaufforderungsfenster angezeigt. In diesem Beispiel wird das Changeset-Dialogfeld von Visual Studio 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