Kommandot Changeset
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Visar information om och gör att du kan ändra attributen, till exempel kommentarer och incheckningsanteckningar, som är associerade med en ändringsuppsättning.
Förutsättningar
Om du vill använda changeset kommandot måste du ha läsbehörigheten inställd på Tillåt för alla filer eller mappar i ändringsuppsättningen som du vill visa fullständig information för. De enda användare som kan ändra anteckningar och kommentarer som är associerade med en ändringsuppsättning är de användare som har skapat ändringsuppsättningen eller en användare som har global behörighet att ändra andra användares ändringar .
Mer information finns i TFVC-standardbehörigheter.
Syntax
tf changeset [/comment:("comment"|@commentfile)]
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]]
[changesetnumber | /latest][/login:username,[password]]
Parametrar
Argument
| Argument | Beskrivning |
|---|---|
comment |
Ger en kommentar om incheckningen. |
@<commentfile> |
Anger en sökväg för en fil på disken som innehåller kommentaren som användes för incheckningen. |
<NoteFieldName>=<NoteFieldValue> |
Anger värdet för incheckningsanteckningsfältet. Du kan ange flera semikolonavgränsade field=value uttryck. |
@<notefile> |
Innehåller sökvägen till en fil på disken som innehåller namn och värden för incheckningsanteckningsfält i formatet field=value med en per rad. |
<TeamProjectCollectionUrl> |
URL:en för projektsamlingen som innehåller en ändringsuppsättning som du vill visa information om eller vars attribut du vill ändra, till exempel http://myserver:8080/tfs/DefaultCollection. |
<username> |
Ger alternativet ett värde /user . Du kan ange det här argumentet som antingen Domain\username eller username. |
<changesetnumber> |
Identifierar den ändringsuppsättning som ska granskas eller ändras. Det går inte att använda med /latest. |
Alternativ
| Alternativ | Beskrivning |
|---|---|
/comment |
Ersätter kommentaren för ändringsuppsättningen som skapades under incheckningsprocessen med en ny kommentar. |
/notes |
Innehåller en eller flera incheckningsanteckningar som ska associeras med ändringsuppsättningen. |
/latest |
Anger den senaste ändringsuppsättningen. Det går inte att använda med <changesetnumber>. |
/noprompt |
Undertrycker alla uppmaningar om indata från dig. |
/collection |
Anger projektsamlingen. |
/login |
Anger användarnamnet och lösenordet för att autentisera användaren med Azure DevOps. |
Kommentarer
En ändringsuppsättning är en uppsättning fil- och mapprevisioner som har checkats in till Team Foundations versionskontrollserver som en del av samma incheckningshändelse. Mer information finns i Arbeta med ändringsuppsättningar.
Du kan använda changeset kommandot för att visa attributen för en ändringsuppsättning och ändra dess egenskaper. Du kan använda history kommandot för att avgöra vilka ändringar du vill hämta information om. Mer information finns i Historikkommando.
Mer information om hur du använder tf kommandoradsverktyget finns i Använda Team Foundation-versionskontrollkommandon.
Exempel
I följande exempel visas detaljerad information om ändringsuppsättningen 8675309 i ett redigerbart format i dialogrutan Visual Studio Details for Changeset 8675309 – Source Files och ersätter den befintliga kommentaren med Det här är en ny kommentar.
c:\projects>tf changeset /comment:"This is a new comment." 8675309
När du har angett kommandot går du till dialogrutan Visual Studio Details for Changeset 8675309 – Source Files och väljer Spara för att associera kommentaren med ändringsuppsättningen.
I följande exempel finns två incheckningsanteckningar som ska associeras med ändringsuppsättningen.
c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309
I följande exempel finns två incheckningsanteckningar som innehåller blanksteg i de värden och namn som ska associeras med ändringsuppsättningen.
c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309
I följande exempel associeras de incheckningsanteckningar som ingår i filen notes.txt med ändringsuppsättningen 8675309.
c:\projects>tf changeset /notes:@notes.txt 8675309
Där notes.txt kan vara i följande format:
field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;
I följande exempel ersätts den befintliga kommentaren för ändringsuppsättningen 8675309 och visar information om ändringsuppsättningen i kommandotolkens fönster. Det här exemplet öppnar inte dialogrutan Visual Studio Changeset .
c:\projects>tf changeset /comment:"This is an automatically generated comment." /noprompt 8675309
I följande exempel visas icke-redigerbar information om ändringsuppsättningar 8675309 i kommandotolkens fönster.
c:\projects>tf changeset 8675309 /noprompt
Exempel på utdata:
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