Polecenie zestaw zmian
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