Команда label (система управления версиями Team Foundation)

  • Статья

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

Visual Studio 2019 | Visual Studio 2022

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

Необходимые компоненты

Чтобы использовать label команду, необходимо иметь разрешение Label в значение Allow. Чтобы изменить или удалить метки, созданные другими пользователями, необходимо иметь разрешение Администратор ister меток в значение 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]

Параметры

Аргументы

Argument

Description

<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.

Параметры

Параметр

Description

/owner

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

/version

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

/comment

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

/child

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

/recursive

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

/delete

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

/login

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

/collection

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

Замечания

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

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

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

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

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

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

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

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

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

Имена меток должны быть уникальными в пределах указанного область. При добавлении метки зарезервировать использование этого имени метки в указанной или подразумеваемой область. Значением по умолчанию для @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 к версии 3 314.cs на сервере 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