Команда блокировки (система управления версиями Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Команда система управления версиями Team Foundation (TFVC) lock
блокирует или разблокирует файл или папку. Команда запрещает или восстанавливает право пользователей проверка элемента для редактирования в другой рабочей области или проверка в ожидающих изменениях элемента из другой рабочей области.
Необходимые компоненты
Чтобы использовать lock
команду, у вас должен быть задан параметр "Разрешить блокировка". Вам нужен набор разрешений на разблокировку изменений другого пользователя, чтобы разрешить удалить блокировку, удерживаемую другим пользователем, если у вас нет разрешения на запись для рабочей области этого пользователя. Дополнительные сведения см. в разделе "Разрешения TFVC по умолчанию".
Синтаксис
tf lock itemspec /lock:(none|checkout|checkin)
[/workspace:workspacename] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Параметры
Аргументы
Argument
Description
<itemspec>
Определяет файл или папку для блокировки или разблокировки. Дополнительные сведения о том, как TFVC анализирует itemspec
элементы, находящиеся в область, см. в разделе "Использование параметров для изменения функций команд".
Примечание.
Можно указать несколько itemspec
аргументов.
<workspacename>
Указанное пользователем /workspace
значение параметра.
<username>
Предоставляет значение /login
для параметра. Можно указать username
значение как DOMAIN\username
или username
.
<TeamProjectCollectionUrl>
URL-адрес коллекции проектов, содержащей файл или папку, которую требуется заблокировать или разблокировать, например http://myserver:8080/tfs/DefaultCollection
.
Параметры
Параметр
Description
/lock
Указывает тип блокировки или удаляет блокировку из элемента. Дополнительные сведения см. в разделе "Общие сведения о типах блокировки".
Параметры блокировки:
None
: удаляет блокировку из элемента.Checkin
: позволяет проверка элемент проверка и изменяться во всех рабочих областях, но запрещает пользователям проверка изменения элемента за пределами указанного/workspace
, пока не будет явно выпущена блокировка проверка. Если указанный элемент заблокирован в любой другой рабочей области, операция блокировки завершается ошибкой.Checkout
: запрещает пользователям проверка в проверка проверка указанных элементов, пока не будет явно освобождена блокировка. Если пользователи заблокировали любой из указанных элементов или если ожидающие изменения существуют для любого из элементов, операция блокировки завершается ошибкой.
/workspace
Указывает имя другой рабочей области, в которой необходимо применить блокировку. По умолчанию блокировка применяется в рабочей области, в которой вы сейчас находитесь.
/login
Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps.
/collection
Указывает коллекцию проектов.
Замечания
С помощью команды блокировки можно временно заморозить версию сервера TFVC элемента, чтобы можно было проверка в ожидающих изменениях без необходимости разрешать любые конфликт слияния. Если вы хотите окончательно запретить доступ к элементу на сервере TFVC, следует использовать команду "Разрешение".
Примечание.
Как любезно вашим товарищам по команде, уведомите их, когда вы применяете блокировку к элементу, объясните, почему вы делаете это, и оцените, когда вы планируете удалить блокировку, если вы можете.
Дополнительные сведения об использовании служебной tf
программы командной строки см. в разделе "Использование команд управления версиями Team Foundation".
Блокировка элемента
Вы можете заблокировать элемент с помощью lock
команды или указать lock
параметр во время выполнения нескольких других tf
команд служебной программы командной строки, в том числе:
- Команда переименования (система управления версиями Team Foundation)
- Команды проверки и редактирования
- Команда delete (система управления версиями Team Foundation)
- Команда отмены
- Команда слияния
- Команда Branch
- Добавить команду
Для add
и branch
, блокировка помещается в пространство имен, где будет создан новый элемент. Блокировки, помещенные как к rename
старым, так и к новым пространствам имен. Дополнительные сведения см. в разделе "Блокировка и разблокировка папок или файлов".
Типы блокировки
TFVC предоставляет два типа блокировок: checkin
и checkout
.
Блокировка проверка менее ограничена, чем блокировка проверка-out. При применении блокировки проверка пользователи могут продолжать вносить локальные изменения в элемент в других рабочих областях. Изменения нельзя проверка, пока вы явно не удалите блокировку проверка из рабочей области.
Блокировка проверка более ограничена, чем блокировка проверка. При применении блокировки проверка-out к управляемому версиям файлу или папке пользователи не могут проверка элемент для редактирования или проверка в предварительно существующих ожидающих изменениях. Вы не можете получить блокировку проверка-out, если в настоящее время есть какие-либо ожидающие изменения элемента.
Дополнительные сведения о применении блокировки проверка и о том, когда следует применить блокировку проверка, см. в разделе "Общие сведения о типах блокировки".
Как работает блокировка
Если при блокировке файла проверка отключен, его состояние изменяется, чтобы он содержал новый тип блокировки. Если файлы не проверка отключены, в набор ожидающих изменений рабочей области добавляется изменение блокировки. checkout
В отличие от команды, lock
не делает файл редактируемым автоматически.
Блокировки папок неявно рекурсивны. Если вы заблокируете папку, вам не нужно блокировать файлы, содержащиеся в ней, если вы не хотите применить более строгий проверка блокировки к файлу в папке с блокировкой проверка.
Разблокировка элемента
Вы можете разблокировать заблокированный элемент с помощью none
параметра. TFVC также автоматически разблокирует элемент при проверка в ожидающих изменениях в рабочей области.
Вы можете определить, какие файлы заблокированы на сервере TFVC, а файлы были заблокированы с помощью команды "Состояние".
Примеры
В следующем примере другие пользователи не проверка 314.cs.
c:\projects>tf lock /lock:checkout 314.cs
В следующем примере другие пользователи не проверка изменений в 1256.cs, но позволяют проверка их проверка в рабочих областях.
c:\projects>tf lock /lock:checkin 1256.cs
В следующем примере другие пользователи не могут добавлять изменения в любые элементы в папке $/src на сервере TFVC.
c:\projects>tf lock /lock:checkout $/src
Следующий пример разблокирует и делает все файлы в папке сервера $/src TFVC доступными для проверка и проверка-in другими пользователями.
c:\projects>tf lock /lock:none $/src