Příkaz Changeset

  • Článek

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

Visual Studio 2019 | Visual Studio 2022

Zobrazí informace o atributech, jako jsou komentáře a poznámky k vrácení se změnami, které jsou přidružené ke sadě změn.

Požadavky

Chcete-li použít changeset příkaz, musíte mít nastavena oprávnění ke čtení povolit pro všechny soubory nebo složky v sadě změn, pro které chcete zobrazit úplné informace. Jedinými uživateli, kteří mohou upravovat poznámky a komentáře přidružené ke sadě změn, jsou uživatelé, kteří vytvořili sadu změn, nebo uživatel, který má globální oprávnění Revidovat změny jiného uživatele.

Další informace naleznete v tématu Výchozí oprávnění TFVC.

Syntaxe

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

Parametry

Argument

Argument Popis
comment Poskytuje komentář k vrácení se změnami.
@<commentfile> Určuje cestu k souboru na disku, který obsahuje komentář použitý pro vrácení se změnami.
<NoteFieldName>=<NoteFieldValue> Nastaví hodnotu pole pro vrácení se změnami. Můžete zadat více výrazů oddělených středníkem field=value .
@<notefile> Poskytuje cestu k souboru na disku, který obsahuje názvy polí a hodnoty pro vrácení se změnami ve formátu field=value s jedním řádkem.
<TeamProjectCollectionUrl> Adresa URL kolekce projektu, která obsahuje sadu změn, o které chcete zobrazit informace nebo jejichž atributy chcete například upravit http://myserver:8080/tfs/DefaultCollection.
<username> Poskytuje hodnotu možnosti /user . Tento argument můžete zadat buď nebo Domain\usernameusername.
<changesetnumber> Identifikuje sadu změn, která se má zkontrolovat nebo upravit. Nelze použít s /latest.

Možnost

Možnost Popis
/comment Nahradí komentář sady změn, který byl vytvořen během procesu vrácení se změnami, novým komentářem.
/notes Poskytuje jednu nebo více poznámek k vrácení se změnami, které se mají přidružit ke sadě změn.
/latest Určuje nejnovější sadu změn. Nelze použít s <changesetnumber>.
/noprompt Potlačí všechny výzvy k zadání vstupu od vás.
/collection Určuje kolekci projektů.
/login Určuje uživatelské jméno a heslo pro ověření uživatele pomocí Azure DevOps.

Poznámky

Sada změn je sada revizí souborů a složek, které byly potvrzeny na server správy verzí Team Foundation jako součást stejné události vrácení se změnami. Další informace naleznete v tématu Práce se sadami změn.

Pomocí příkazu můžete changeset zobrazit atributy sady změn a upravit jeho vlastnosti. Pomocí příkazu můžete history určit, o které sadě změn chcete získat informace. Další informace naleznete v tématu Příkaz historie.

Další informace o tom, jak používat nástroj příkazového tf řádku, naleznete v tématu Použití příkazů správy verzí Team Foundation.

Příklady

Následující příklad zobrazí podrobné informace o sadě změn 8675309 v upravitelném formátu v sadě Visual Studio Details for Changeset 8675309 – Zdrojové soubory dialogové okno a nahradí existující komentář tímto novým komentářem.

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

Po zadání příkazu v sadě Visual Studio Details for Changeset 8675309 – Zdrojové soubory vyberte Uložit a přidružte komentář k sadě změn.

Následující příklad obsahuje dvě poznámky k vrácení se změnami pro přidružení k sadě změn.

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

Následující příklad obsahuje dvě poznámky k vrácení se změnami, které obsahují mezery v hodnotách a názvech, které se mají přidružit ke sadě změn.

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

Následující příklad přidruží poznámky k vrácení se změnami zahrnuté v souboru notes.txt se sadou změn 8675309.

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

Kde notes.txt může být v následujícím formátu:

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

Následující příklad nahradí existující komentář pro sadu změn 8675309 a zobrazí informace o sadě změn v okně příkazového řádku. Tento příklad neotevře dialogové okno Sady změn sady Visual Studio.

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

Následující příklad zobrazí nepravitelné informace o sadě změn 8675309 v okně příkazového řádku.

c:\projects>tf changeset 8675309 /noprompt

Ukázkový výstup:

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