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

Команда Label (Управление версиями Team Foundation)

  • Статья

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

Visual Studio 2019 | Visual Studio 2022

Команда Team Foundation Version Control (TFVC) tf label подключает метку к или удаляет метку из версии файла или папки на сервере TFVC.

Необходимые условия

Чтобы использовать команду , укажите разрешение метки значение Allow. Чтобы изменить или удалить метки, созданные другими пользователями, укажите разрешения на администрирование меток значение Allow. Дополнительные сведения см. в разделе разрешения TFVC по умолчанию.

Синтаксис

tf label labelname[@scope] [/owner:ownername] 
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)] 
[/child:(replace|merge)] [/recursive] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]	

tf label /delete labelname[@scope] 
itemspec [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Параметры

Аргументы

аргумент

описание

<labelname>

Определяет имя метки для присоединения, изменения или удаления из указанных элементов.

@<scope>

Указывает каталог сервера TFVC, в котором labelname является уникальным. Этот параметр позволяет независимо создавать, управлять, извлекать и удалять одну метку или набор помеченных элементов, если две метки одного и того же имени находятся в разных частях сервера TFVC.

<ownername>

Предоставляет значение, например DOMAIN\JuanGo или только juango параметру /owner.

<itemspec>

Идентифицирует файл или папку, из которой выполняется метка, повторная метка или изменение. Дополнительные сведения о том, как TFVC анализирует itemspec, чтобы определить, какие элементы находятся в области, см. в разделе Использование команд управления версиями Team Foundation.

Заметка

Можно указать несколько itemspec аргументов.

<versionspec>

Предоставляет значение, например c2 для параметра /version. Дополнительные сведения о том, как TFVC анализирует спецификацию версии, чтобы определить, какие элементы находятся в пределах области, см. в разделе Использование команд управления версиями Team Foundation.

<comment>

Предоставленный пользователем комментарий о метки.

@<commentfile>

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

<username>

Предоставляет значение для параметра /login. Можно указать значение имени пользователя как DOMAIN\username или username.

<TeamProjectCollectionUrl>

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

Параметры

параметра

описание

/owner

Указывает имя пользователя, которому принадлежит метка.

/version

Необязательный. Указывает версию файла или папки, к которой должна быть присоединена метка, изменена или из которой должна быть удалена метка. Это значения набора изменений, например C93. По умолчанию TFVC использует базовую версию рабочей области, если versionspec не предоставляется.

/comment

Добавляет или изменяет описание или комментарий для метки.

/child

Не документирован.

/recursive

Метки всех элементов в каталоге, которые соответствуют itemspec и versionspec. Невозможно использовать с параметром /delete.

/delete

Удаляет метку.

/login

Указывает имя пользователя и пароль для проверки подлинности пользователя с помощью Azure DevOps.

/collection

Указывает коллекцию проектов.

Замечания

Метка — это маркер, который можно подключить к набору не связанных файлов и папок на сервере TFVC. Используйте метку для упрощения извлечения файлов и папок в рабочую область для целей разработки или сборки. Метка похожа на набор изменений или дату и время, из которых можно произвольно добавлять и удалять файлы и папки или изменять версии элементов. Метка — это спецификация версии, которую можно передать в следующие команды TFVC:

  • команда Branch
  • команда отличия
  • команда Dir
  • команда Get
  • команда журнала
  • команда слияния
  • команда представления

Распространенные типы меток — это метки вехи, такие как M1, Beta2или Release Candidate 0.

Метки зависят от версии. То есть можно присоединить метку только к одной версии файла или папки. Каждая версия элемента может поддерживать несколько меток.

Метка не является версией объекта. Поэтому журнал меток файлов не отслеживается. Кроме того, операция метки не создает ожидающие изменения в рабочей области. При выполнении команды label обновление сразу же отражается на сервере TFVC.

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

Удаление и удаление меток

Вы можете использовать команду Unlabel для удаления метки из файла или папки. Кроме того, можно удалить метку из системы с помощью команды tf label /delete.

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

Управление перегруженными метками

Имена меток должны быть уникальными в пределах указанной области. При добавлении метки зарезервировать использование этого имени метки в указанной или подразумеваемой области. Значением по умолчанию для параметра @scope является проект, например $/TeamProject1.

Если другая команда или пользователь добавляет общую метку, например M3 в набор файлов, управляемых версиями, в другой части сервера TFVC можно применить метку M3 к файлам, управляемым версиями в проекте, если корневые папки проекта находятся в разных каталогах. Например, если файлы в каталоге $/math помечены M3, можно также применить метку M3 к файлам в каталоге $/projects.

Чтобы получить, удалить метку или управлять M3-помеченными элементами, следует указать параметр @scope, чтобы указать TFVC, с какой M3 меткой вы хотите работать.

Вы можете запретить другим пользователям перегружать метку, например M3 в разных частях сервера TFVC, создав метку в корневой $/ сервера управления версиями Team Foundation или изменив разрешения Метки для определенных папок.

Примеры

В следующем примере метка goodbuild присоединяется к версии рабочей области документов и файлов и папок, содержащихся в ней.

c:\projects>tf label goodbuild docs /recursive

В следующем примере метка goodbuild присоединяется к папке документации, но не к файлам и папкам, которые содержатся в документах.

c:\projects>tf label goodbuild docs

В следующем примере метка goodbuild присоединяется к 314.cs версии 3 на сервере TFVC.

c:\projects>tf label goodbuild /version:3 $/src/314.cs

В следующем примере удаляется метка badbuild из всех элементов на сервере TFVC.

c:\projects>tf label /delete badbuild

В следующем примере используется параметр области @ для применения метки к 314.cs.

c:\projects>tf label goodbuild@$/TeamProject1 314.cs