Команда changeset
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Отображает сведения об и позволяет изменять атрибуты, такие как примечания и заметки проверка, связанные с набором изменений.
Необходимые компоненты
Чтобы использовать changeset эту команду, необходимо задать разрешение на чтение для всех файлов или папок в наборе изменений, для которого требуется отобразить полную информацию. Единственными пользователями, которые могут изменять заметки и комментарии, связанные с набором изменений, являются пользователи, которые создали набор изменений или пользователь, имеющий глобальное разрешение на изменение других пользователей.
Дополнительные сведения см. в разделе "Разрешения TFVC по умолчанию".
Синтаксис
tf changeset [/comment:("comment"|@commentfile)]
[/notes:("NoteFieldName"="NoteFieldValue"|@notefile)] [/noprompt][/collection:TeamProjectCollectionUrl]]
[changesetnumber | /latest][/login:username,[password]]
Параметры
Аргумент
| Argument | Description |
|---|---|
comment |
Предоставляет комментарий о проверка-in. |
@<commentfile> |
Указывает путь к файлу на диске, который содержит комментарий, используемый для проверка-in. |
<NoteFieldName>=<NoteFieldValue> |
Задает значение поля заметки проверка. Можно указать несколько разделенных точкой с запятой field=value выражений. |
@<notefile> |
Предоставляет путь к файлу на диске, который содержит имена полей и значения полей заметок проверка в формате field=value с одной строкой. |
<TeamProjectCollectionUrl> |
URL-адрес коллекции проектов, содержащей набор изменений, о котором требуется отобразить сведения или атрибуты, которые необходимо изменить, например http://myserver:8080/tfs/DefaultCollection. |
<username> |
Предоставляет значение /user для параметра. Этот аргумент можно указать как или Domain\username username. |
<changesetnumber> |
Определяет набор изменений для проверки или изменения. Не может использоваться с /latest. |
Вариант
| Параметр | Description |
|---|---|
/comment |
Заменяет комментарий набора изменений, созданный во время процесса проверка, новым комментарием. |
/notes |
Предоставляет одну или несколько заметок проверка для связывания с набором изменений. |
/latest |
Задает последний набор изменений. Не может использоваться с <changesetnumber>. |
/noprompt |
Подавляет любые запросы на входные данные. |
/collection |
Указывает коллекцию проектов. |
/login |
Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps. |
Замечания
Набор изменений — это набор исправлений файлов и папок, которые были зафиксированы на сервере управления версиями Team Foundation в рамках того же события проверка-in. Дополнительные сведения см. в разделе "Работа с наборами изменений".
Команду можно использовать changeset для просмотра атрибутов набора изменений и изменения его свойств. Вы можете использовать history команду для определения набора изменений, о котором вы хотите получить сведения. Дополнительные сведения см. в разделе "Команда журнала".
Дополнительные сведения об использовании служебной tf программы командной строки см. в разделе "Использование команд управления версиями Team Foundation".
Примеры
В следующем примере отображаются подробные сведения о наборе изменений 8675309 в редактируемом формате в диалоговом окне "Подробные сведения о наборе 8675309 изменений" в Visual Studio — диалоговое окно "Исходные файлы" и замена существующего комментария новым комментарием.
c:\projects>tf changeset /comment:"This is a new comment." 8675309
После ввода команды в диалоговом окне "Сведения о наборе изменений" Visual Studio 8675309 — исходные файлы нажмите кнопку "Сохранить ", чтобы связать комментарий с набором изменений.
В следующем примере содержатся два проверка заметки для связывания с набором изменений.
c:\projects>tf changeset /notes:reviewer=Jo;Security = checked 8675309
В следующем примере содержатся два проверка заметки, которые включают пробелы в значениях и именах, которые необходимо связать с набором изменений.
c:\projects>tf changeset /notes:"Code Reviewer"="John Smith";"Security Reviewer"="Chen Yang" 8675309
Следующий пример связывает заметки проверка, включенные в файл, notes.txt с набором изменений 8675309.
c:\projects>tf changeset /notes:@notes.txt 8675309
Где notes.txt может находиться в следующем формате:
field1=value1;
field2=value that
spans multiple
lines;
field3 = value3;
Следующий пример заменяет существующий комментарий для набора изменений 8675309 и отображает сведения о наборе изменений в окне командной строки. В этом примере не открывается диалоговое окно "Набор изменений Visual Studio".
c:\projects>tf changeset /comment:"This is an automatically generated comment." /noprompt 8675309
В следующем примере отображаются нередактируемые сведения о наборе изменений 8675309 в окне командной строки.
c:\projects>tf changeset 8675309 /noprompt
Образец вывода:
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