Поделиться через

Команда 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]]

Параметры

Аргумент

аргумент описание
comment Предоставляет комментарий о входе.
@<commentfile> Указывает путь к файлу на диске, который содержит комментарий, используемый для регистрации.
<NoteFieldName>=<NoteFieldValue> Задает значение поля заметки для проверки. Можно указать несколько выражений, разделенных точкой с запятой, field=value.
@<notefile> Предоставляет путь к файлу на диске, который содержит имена и значения полей заметок в формате field=value по одной строке.
<TeamProjectCollectionUrl> URL-адрес коллекции проектов, содержащий набор изменений, о котором требуется отображать сведения или атрибуты, которые необходимо изменить, например, http://myserver:8080/tfs/DefaultCollection.
<username> Предоставляет значение для параметра /user. Этот аргумент можно указать как Domain\username или username.
<changesetnumber> Определяет набор изменений для проверки или изменения. Нельзя использовать с /latest.

Выбор

параметра описание
/comment Заменяет комментарий набора изменений, созданный во время процесса регистрации, новым комментарием.
/notes Предоставляет одну или несколько заметок для регистрации для связывания с набором изменений.
/latest Задает последний набор изменений. Нельзя использовать с <changesetnumber>.
/noprompt Подавляет любые запросы на входные данные.
/collection Указывает коллекцию проектов.
/login Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps.

Замечания

набор изменений — это набор исправлений файлов и папок, которые были зафиксированы на сервере управления версиями Team Foundation в рамках одного события проверки. Дополнительные сведения см. в разделе Работа с наборами изменений.

Команду changeset можно использовать для просмотра атрибутов набора изменений и изменения его свойств. Вы можете использовать команду history для определения набора изменений, о котором вы хотите получить сведения. Дополнительные сведения см. в разделекоманды журнала .

Дополнительные сведения об использовании служебной программы командной строки tf см. в разделе Использование команд управления версиями Team Foundation.

Примеры

В следующем примере отображаются подробные сведения о наборе изменений 8675309 в редактируемом формате в диалоговом окне "Сведения о наборе изменений" Visual Studio 8675309 — исходные файлы и заменяет существующий комментарий Это новый комментарий.

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