Udostępnij za pośrednictwem

Polecenie zestaw zmian

  • Artykuł

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

Visual Studio 2019 | Program Visual Studio 2022

Wyświetla informacje o i umożliwia zmianę atrybutów, takich jak komentarze i notatki ewidencjonowane, które są skojarzone z zestawem zmian.

Warunki wstępne

Aby użyć polecenia changeset, należy ustawić uprawnienie Odczyt na Zezwalaj na wszystkie pliki lub foldery w zestawie zmian, dla których chcesz wyświetlić pełne informacje. Jedynymi użytkownikami, którzy mogą modyfikować notatki i komentarze skojarzone z zestawem zmian, są użytkownicy, którzy utworzyli zestaw zmian lub użytkownik, który ma Popraw zmiany innych użytkowników uprawnienia globalne.

Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia serwera TFVC.

Składnia

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

Parametry

Argument

argumentów opis
comment Zawiera komentarz dotyczący zaewidencjonu.
@<commentfile> Określa ścieżkę pliku na dysku, który zawiera komentarz używany do zaewidencjonowania.
<NoteFieldName>=<NoteFieldValue> Ustawia wartość pola zaewidencjonowania. Można podać wiele rozdzielonych średnikami wyrażeń field=value.
@<notefile> Zawiera ścieżkę pliku na dysku, który zawiera nazwy pól zaewidencjonowania i wartości w formacie field=value z jednym na wiersz.
<TeamProjectCollectionUrl> Adres URL kolekcji projektów, który zawiera zestaw zmian, o którym chcesz wyświetlić informacje lub którego atrybuty chcesz zmodyfikować, na przykład http://myserver:8080/tfs/DefaultCollection.
<username> Udostępnia wartość opcji /user. Ten argument można określić jako Domain\username lub username.
<changesetnumber> Określa zestaw zmian do przejrzenia lub zmodyfikowania. Nie można używać z /latest.

Opcja

opcji opis
/comment Zastępuje komentarz zestawu zmian, który został utworzony podczas procesu ewidencjonu, nowym komentarzem.
/notes Zawiera co najmniej jedną notatkę zaewidencjonowania do skojarzenia z zestawem zmian.
/latest Określa najnowszy zestaw zmian. Nie można używać z <changesetnumber>.
/noprompt Pomija wszelkie monity dotyczące danych wejściowych.
/collection Określa kolekcję projektów.
/login Określa nazwę użytkownika i hasło do uwierzytelniania użytkownika za pomocą usługi Azure DevOps.

Uwagi

Zestaw zmian to zestaw poprawek plików i folderów, które zostały zatwierdzone na serwerze kontroli wersji programu Team Foundation w ramach tego samego zdarzenia ewidencjonowania. Aby uzyskać więcej informacji, zobacz Praca z zestawami zmian.

Za pomocą polecenia changeset można wyświetlić atrybuty zestawu zmian i zmodyfikować jego właściwości. Możesz użyć polecenia history, aby określić zestaw zmian, o którym chcesz uzyskać informacje. Aby uzyskać więcej informacji, zobacz History Command.

Aby uzyskać więcej informacji na temat korzystania z narzędzia wiersza polecenia tf, zobacz Używanie poleceń kontroli wersji programu Team Foundation.

Przykłady

Poniższy przykład przedstawia szczegółowe informacje o zestawie zmian 8675309 w formacie edytowalnym w programie Visual Studio Szczegóły zestawu zmian 8675309 — pliki źródłowe okno dialogowe i zastępuje istniejący komentarz To jest nowy komentarz.

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

Po wprowadzeniu polecenia w oknie dialogowym Szczegóły zestawu 8675309 zmian programu Visual Studio — pliki źródłowe wybierz Zapisz, aby skojarzyć komentarz ze zestawem zmian.

W poniższym przykładzie przedstawiono dwie notatki zaewidencjonowania, które mają być skojarzone z zestawem zmian.

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

Poniższy przykład zawiera dwie notatki zaewidencjonowania, które zawierają spacje w wartościach i nazwach do skojarzenia z zestawem zmian.

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

Poniższy przykład kojarzy notatki ewidencjonujące zawarte w pliku notes.txt z zestawem zmian 8675309.

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

Gdzie notes.txt może mieć następujący format:

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

Poniższy przykład zastępuje istniejący komentarz dla zestawu zmian 8675309 i wyświetla informacje o zestawie zmian w oknie wiersza polecenia. Ten przykład nie otwiera okna dialogowego zestawu zmian programu Visual Studio .

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

W poniższym przykładzie wyświetlane są nieedytowalne informacje o zestawie zmian 8675309 w oknie wiersza polecenia.

c:\projects>tf changeset 8675309 /noprompt

Przykładowe dane wyjściowe:

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