Команда блокировки (система управления версиями 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 команд служебной программы командной строки, в том числе:

Для 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