Comando label (Control de versiones de Team Foundation)

  • Artículo

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

Visual Studio 2019 | Visual Studio 2022

El comando tf label de Control de versiones de Team Foundation (TFVC) adjunta o quita una etiqueta de una versión de un archivo o carpeta en el servidor de TFVC.

Requisitos previos

Para usar el comando label, debe tener el permiso Etiqueta establecido en Permitir. Para modificar o eliminar etiquetas creadas por otros usuarios, debe tener el permiso Administrar etiquetas establecido en Permitir. Para obtener más información, vea Permisos de TFVC predeterminados.

Sintaxis

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]

Parámetros

Argumentos

Argument

Descripción

<labelname>

Identifica el nombre de la etiqueta que se va a adjuntar, modificar o quitar de los elementos especificados.

@<scope>

Especifica un directorio de servidor TFVC en el que labelname es único. Este parámetro permite crear, administrar, recuperar y eliminar de forma independiente una etiqueta o un conjunto de elementos etiquetados cuando dos etiquetas con el mismo nombre están en partes distintas del servidor de TFVC.

<ownername>

Proporciona un valor como DOMAIN\JuanGo o simplemente juango a la opción /owner.

<itemspec>

Identifica el archivo o carpeta desde donde se va a etiquetar, volver a etiquetar o modificar. Para obtener más información sobre cómo TFVC analiza itemspec para determinar qué elementos están dentro de su ámbito, vea Uso de comandos de Control de versiones de Team Foundation.

Nota:

Puede especificar más de un argumento itemspec.

<versionspec>

Proporciona un valor como c2 para la opción /version. Para obtener más información sobre cómo TFVC analiza una especificación de versión para determinar qué elementos están dentro de su ámbito, vea Uso de comandos de Control de versiones de Team Foundation.

<comment>

Comentario proporcionado por el usuario sobre la etiqueta.

@<commentfile>

Ruta de acceso proporcionada por el usuario de un archivo en disco que contiene el comentario que se va a usar con la etiqueta.

<username>

Proporciona un valor a la opción /login. Se puede especificar un valor de nombre de usuario como DOMAIN\username o username.

<TeamProjectCollectionUrl>

Dirección URL de la colección de proyectos especificada que contiene una versión de un archivo o una carpeta donde se desea adjuntar o eliminar una etiqueta, por ejemplo, http://myserver:8080/tfs/DefaultCollection.

Opciones

Opción

Descripción

/owner

Especifica el nombre del usuario propietario de la etiqueta.

/version

Opcional. Especifica la versión del archivo o la carpeta donde se debe adjuntar, modificar o quitar la etiqueta. Se trata de valores de conjunto de cambios, por ejemplo, C93. TFVC usa de forma predeterminada la versión de área de trabajo base si versionspec no se proporciona.

/comment

Agrega o modifica una descripción o comentario sobre la etiqueta.

/child

No está documentado.

/recursive

Etiqueta todos los elementos del directorio que coinciden con itemspec y versionspec. No se puede usar con la opción /delete.

/delete

Quita la etiqueta.

/login

Especifica el nombre de usuario y la contraseña para autenticar al usuario con Azure DevOps.

/collection

Especifica el nombre de la colección de proyectos.

Observaciones

Una etiqueta es un marcador que se puede adjuntar a un conjunto de archivos y carpetas no relacionados en el servidor de TFVC. Use la etiqueta para simplificar la recuperación de archivos y carpetas en un área de trabajo con fines de desarrollo o compilación. Una etiqueta es como un conjunto de cambios o una fecha/hora donde se pueden agregar y quitar archivos y carpetas de forma arbitraria o cambiar las versiones de los elementos que contienen. Una etiqueta es una especificación de versión que se puede pasar a los siguientes comandos de TFVC:

Los tipos de etiqueta comunes son hitos de etiqueta como M1, Beta2 o Release Candidate 0.

Las etiquetas son específicas de una versión; es decir, solo se puede adjuntar una etiqueta a una versión de un archivo o una carpeta. Cada versión de un elemento puede admitir varias etiquetas.

Una etiqueta no es un objeto con versiones, de ahí que no se haga un seguimiento del historial de etiquetas de los archivos. Del mismo modo, una operación de etiqueta no crea un cambio pendiente en el área de trabajo. Cuando se emite el comando label, la actualización se refleja inmediatamente en el servidor de TFVC.

Para obtener más información sobre cómo usar la utilidad de línea de comandos tf, vea Uso de comandos de Control de versiones de Team Foundation.

Eliminación de etiquetas

Puede usar el comando unlabel para quitar una etiqueta de un archivo o una carpeta. Como alternativa, también se pueden eliminar etiquetas del sistema con el comando tf label /delete.

Para obtener información sobre una etiqueta existente que incluye una lista de los elementos a los que se ha adjuntado la etiqueta, así como el correspondiente comentario, ámbito y propietario, vea Comando labels.

Administración de etiquetas sobrecargadas

Los nombres de etiqueta deben ser únicos en todo el ámbito que se haya especificado. Al agregar una etiqueta, se reserva el uso de ese nombre de etiqueta en o bajo el ámbito especificado o implícito. El valor predeterminado del parámetro @scope es el proyecto, por ejemplo, $/TeamProject1.

Si otro equipo o usuario agrega una etiqueta común, como M3, a un conjunto de archivos controlados por versiones en otra parte del servidor de TFVC, la etiqueta M3 se puede aplicar a los archivos controlados por versiones en el proyecto, siempre que las carpetas del proyecto raíz estén en directorios distintos. Por ejemplo, si los archivos del directorio $/math están etiquetados como M3, la etiqueta M3 se puede aplicar también a los archivos del directorio $/projects.

Para obtener o quitar una etiqueta (o para administrar los elementos etiquetados con M3), hay que especificar el parámetro @scope para informar a TFVC de la etiqueta M3 con la que se quiere trabajar.

Para impedir que otros usuarios "sobrecarguen" una etiqueta, como M3, en diferentes partes del servidor de TFVC, cree la etiqueta en la raíz $/ del servidor de control de versiones de Team Foundation o ajuste los permisos Etiqueta de determinadas carpetas.

Ejemplos

En el siguiente ejemplo se adjunta la etiqueta goodbuild a la versión de área de trabajo de la carpeta docs y los archivos y las carpetas que contiene.

c:\projects>tf label goodbuild docs /recursive

En el siguiente ejemplo se adjunta la etiqueta goodbuild a la carpeta docs, pero no a los archivos y las carpetas que la carpeta docs contiene.

c:\projects>tf label goodbuild docs

En el siguiente ejemplo se adjunta la etiqueta goodbuild a la versión 3 de 314.cs en el servidor de TFVC.

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

En el siguiente ejemplo se elimina la etiqueta badbuild de todos los elementos del servidor de TFVC.

c:\projects>tf label /delete badbuild

En el siguiente ejemplo se usa la opción de ámbito @ para aplicar una etiqueta a 314.cs.

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