Polecenie zestaw zmian

  • Artykuł

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

Visual Studio 2019 | 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.

Wymagania wstępne

Aby użyć changeset polecenia, musisz mieć uprawnienie Odczyt ustawione 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 mający uprawnienie globalne Poprawianie zmian innych użytkowników.

Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

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

Parametry

Argument

Argument 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 wyrażeń rozdzielonych field=value średnikami.
@<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 projektu, 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ść /user opcji. 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 /latestprogramem .

Opcja

Opcja 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>programem .
/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 zaewidencjonowania. Aby uzyskać więcej informacji, zobacz Praca z zestawami zmian.

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

Aby uzyskać więcej informacji na temat korzystania z tf narzędzia wiersza polecenia, zobacz Use Team Foundation version control commands (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 oknie dialogowym Szczegóły zestawu zmian 8675309 — pliki źródłowe i zastępuje istniejący komentarz komentarzem To jest nowy komentarz.

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

Po wprowadzeniu polecenia w oknie dialogowym Szczegóły zestawu zmian programu Visual Studio dla zestawu zmian 8675309 — pliki źródłowe wybierz pozycję 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