Команда checkin

Статья
03/24/2025

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

Visual Studio 2019 | Visual Studio 2022

Команда TFVC checkin проверяет изменения в ожидающих файлах и папках на сервере.

Почти все изменения, внесенные в файлы на компьютере разработки, хранятся в рабочей области как ожидающие изменения, пока вы не запустите его. При регистрации изменений они хранятся в виде набора изменений на сервере. Команда checkin предоставляет другой пользовательский интерфейс для выполнения одинаковых процессов, описанных для Visual Studio в проверить работу в базе кода команды.

Советы

Чтобы отложить изменения или очистить рабочую область для другой задачи, используйте команду Shelve.
Если конфликты блокируют вход, для их устранения можно использовать команду Разрешить.
Если у компьютера и учетной записи пользователя нет рабочей области, сопоставленной с коллекцией проектов, содержащей набор полок, можно использовать параметры /shelveset и /collection для проверки набора полок.

Предпосылки

Разрешения по умолчанию

Синтаксис

tf checkin [/author:author name] [/comment:("comment"|@comment file)] 
[/noprompt] [/notes:("Note Name"="note text"|@notefile)] 
[/override:(reason|@reasonfile)] [/recursive] [/saved] [/validate] [itemspec] [/bypass] [/force] [/noautoresolve] [/login:username,[password]] [/new]

tf checkin /shelveset:shelvesetname[;shelvesetowner] [/bypass] [/noprompt] [/login:username,[password]] [/collection:TeamProjectCollectionUrl][/author:author name] [/force]

Параметры

Параметр

Описание

/author:<author name>

Определяет автора ожидающих изменений, чтобы пользователь смог проверить изменения от имени другого пользователя.

Требуется разрешение CheckinOther. См. справочные разрешений и групп.

/bypass

Проходит требование для регистрации в закрытом режиме. Дополнительные сведения см. в разделе "Вход в папку", которая управляется процессом сборки, контролируемым воротным процессом сборки.

/collection:<ProjectCollectionUrl>

Если вы используете параметр shelveset, параметр /collection указывает URL-адрес коллекции проектов, содержащей набор полок. Например: http://myserver:8080/tfs/DefaultCollection.

По умолчанию коллекция проектов считается той, которая содержит рабочую область, которая сопоставляет текущий каталог.

/comment

Связывает комментарий с набором изменений с помощью одного из следующих аргументов:

"<comment>": предоставленный пользователем комментарий о регистрации.
@<comment file>: путь к файлу на диске, который содержит комментарий для регистрации.

/force

Принудительно выполняет проверку элементов с ожидающих изменений, даже если в файле нет изменений содержимого.

<itemspec>

Указывает область элементов для входа из рабочей области пользователя. Можно указать несколько itemspec аргументов. Синтаксис см. в разделе Использование команд управления версиями Team Foundation.

/login:<username>[,<password>]

Указывает учетную запись пользователя для выполнения команды. См. команды управления версиями Team Foundation.

/new

Выбранное состояние каждого ожидающего изменения, как показано в диалоговом окне "Возврат". Комментарий, связанные рабочие элементы, заметки о регистрации и переопределение политики регистрации хранятся на компьютере разработки в качестве ожидающих изменений, пока вы не запустите их. Параметр /new очищает эти метаданные проверки перед возвратом. Этот параметр и поведение, изменяющее его, не влияет при использовании параметра /noprompt.

/noautoresolve

По умолчанию система автоматически пытается AutoResolve All конфликтов. Укажите этот параметр, чтобы отключить это поведение по умолчанию. Дополнительные сведения см. в статье Устранение конфликтов управления версиями Team Foundation.

/noprompt

Подавляет отображение окон и диалоговых окон, таких как диалоговое окно check In, и перенаправляет выходные данные в командную строку. См. команды управления версиями Team Foundation.

/notes

Предоставляет одну или несколько заметок для регистрации для связывания с набором изменений с помощью одного из следующих аргументов:

<NoteFieldName>=<NoteFieldValue>: задает значение поля заметки для проверки. Можно указать несколько выражений, разделенных точкой с запятой, field=value.
@<NoteFile>: путь к файлу на диске с именами и значениями полей и значений записей в формате field=value. Плитка с запятой, разделенная запятой, может охватывать несколько строк, например:

<Field1>=<Value1>;
<Field2>=<First line of Value2>;
<Second line of Value2>;
<Field3>=<Value3>;

/override

Переопределяет политику проверки с помощью одного из следующих аргументов:

reason: указанная пользователем причина, по которой политика регистрации игнорируется.
reasonfile: путь к файлу, содержаму пользовательское описание причины, из-за которой политика проверки игнорируется.

/recursive

Рекурсивно проверяет элементы в указанном каталоге и любых подкаталогах.

/saved

Игнорировать этот параметр.

/shelveset:<shelvesetname>[;<owner>]

Указывает набор полок для регистрации. Необязательный аргумент owner указывает набор полок, которым текущий пользователь не владеет.

Примечание.

После проверки набора полок система удаляет ее.

/validate

Проверяет, выполнена ли проверка успешно, без проверки файлов. Система оценивает политики регистрации, заметки о регистрации и списки конфликтов.

Примечание.

Если параметр /noprompt не указан, нажмите кнопку "Проверить" в диалоговом окне "Проверка". После нажатия этой кнопки система не проверяет файлы.

Примеры

В следующих примерах предполагается, что c:\code\SiteApp\Main является главной папкой, сопоставленной с коллекцией проектов в рабочей области пользователя.

Проверка всех ожидающих изменений в текущей рабочей области

Следующая команда отображает диалоговое окно "Проверка", в котором отображаются все ожидающие изменения в текущей рабочей области. Диалоговое окно "Регистрация" позволяет выбрать или очистить ожидающие изменения, которые вы хотите выполнить, добавить комментарий, связать рабочие элементы и выполнить другие задачи, а затем нажмите кнопку "Проверить", когда вы будете готовы продолжить.

c:\code\SiteApp\Main>tf checkin

Проверка всех ожидающих изменений с помощью комментария

Следующий пример проверяет все ожидающие изменения в текущей рабочей области и предоставляет комментарий, чтобы помочь коллегам понять цель изменений.

c:\code\SiteApp\Main>tf checkin /comment:"Re-implemented Pi calculator"

Проверка изменения на один элемент без использования диалогового окна "Флажок"

В следующем примере выполняется проверка ожидающих изменений в program.cs. Диалоговое окно "Проверка" не отображается, и если какие-либо конфликты блокируют проверку, система не отображает окно конфликтов.

c:\code\SiteApp\Main>tf checkin program.cs /noprompt

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