Команда 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\usernameusername.
<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