Compartir a través de

Comando Label (Control de versiones de Team Foundation)

  • Artículo

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

Visual Studio 2019 | de Visual Studio 2022

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

Prerrequisitos

Para usar el comando , establezca el permiso etiqueta en Permitir. Para modificar o eliminar etiquetas creadas por otros usuarios, tenga el permiso Administrar etiquetas establecido en Permitir. Para obtener más información, consulte permisos predeterminados de TFVC.

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

de argumentos de

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 el labelname es único. Este parámetro le permite crear, administrar, recuperar y eliminar de forma independiente una etiqueta o un conjunto de elementos etiquetados cuando dos etiquetas del mismo nombre están en partes diferentes del servidor TFVC.

<ownername>

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

<itemspec>

Identifica el archivo o carpeta desde el que se va a etiquetar, volver a etiquetar o modificar. Para obtener más información sobre cómo TFVC analiza el itemspec para determinar qué elementos están dentro del ámbito, consulte Usar 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, consulte Usar 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 el disco que contiene el comentario que se va a usar para la etiqueta.

<username>

Proporciona un valor a la opción /login. 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 carpeta a la que desea adjuntar una etiqueta o desde la que desea eliminar una etiqueta, por ejemplo, http://myserver:8080/tfs/DefaultCollection.

Opciones

de opción de

descripción

/owner

Especifica el nombre del usuario que posee la etiqueta.

/version

Opcional. Especifica la versión del archivo o la carpeta a la que se debe adjuntar, modificar o desde la que se debe quitar la etiqueta. Estos son valores del conjunto de cambios, por ejemplo, C93. De forma predeterminada, TFVC usa la versión del área de trabajo base si no se proporciona ningún versionspec.

/comment

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

/child

No documentado.

/recursive

Etiqueta todos los elementos del directorio que coinciden con el 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 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 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 y hora a los que puede agregar y quitar archivos y carpetas arbitrariamente o cambiar las versiones de los elementos que contiene. Una etiqueta es una especificación de versión que se puede pasar a los siguientes comandos de TFVC:

  • comando Branch
  • de comando diferencia de
  • del comando Dir de
  • comando Get
  • del comando Historial de
  • de comandos Merge
  • del comando Ver de

Los tipos comunes de etiquetas son etiquetas de hito, como M1, Beta2o Release Candidate 0.

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

Una etiqueta no es un objeto con versiones. Por lo tanto, no se realiza un seguimiento del historial de etiquetas de los archivos. Además, una operación de etiqueta no crea un cambio pendiente en el área de trabajo. Al emitir el comando label, la actualización se refleja inmediatamente en el servidor TFVC.

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

Eliminación y eliminación de etiquetas

Puede usar el comando Unlabel para quitar una etiqueta de un archivo o carpeta. Como alternativa, puede eliminar una etiqueta del sistema mediante 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, su comentario, ámbito y propietario, consulte comando Etiquetas.

Administración de etiquetas sobrecargadas

Los nombres de etiqueta deben ser únicos en todo un ámbito 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 TFVC, puede aplicar la etiqueta M3 a los archivos controlados por versiones del proyecto siempre que las carpetas del proyecto raíz estén en directorios diferentes. Por ejemplo, si los archivos del directorio $/math se etiquetan M3, también puede aplicar la etiqueta M3 a los archivos del directorio $/projects.

Para obtener, quitar una etiqueta o administrar los elementos con etiqueta de M3, debe especificar el parámetro @scope para indicar a TFVC con qué etiqueta M3 desea trabajar.

Puede impedir que otros usuarios "sobrecarguen" una etiqueta como M3 en diferentes partes del servidor TFVC creando la etiqueta en la raíz $/ del servidor de control de versiones de Team Foundation o ajustando permisos de etiqueta para determinadas carpetas.

Ejemplos

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

c:\projects>tf label goodbuild docs /recursive

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

c:\projects>tf label goodbuild docs

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

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

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

c:\projects>tf label /delete badbuild

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

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