Comando label (Control de versiones de Team Foundation)
Actualización: noviembre 2007
Asocia o quita una etiqueta de una versión de un archivo o carpeta en el servidor de Control de versiones de Team Foundation.
Permisos necesarios
Para utilizar el comando label, el permiso Etiqueta debe estar establecido en Permitir. Para modificar o eliminar las etiquetas creadas por otros usuarios, el permiso Administrar etiquetas debe estar establecido en Permitir. Para obtener más información, vea Permisos de Team Foundation Server.
tf label [/server:servername] labelname[@scope] [/owner:ownername]
itemspec [/version:versionspec] [/comment:("comment"|@commentfile)]
[/child:(replace|merge)] [/recursive]
tf label [/server:servername] /delete labelname[@scope]
[/owner:ownername] itemspec [/version:versionspec]
Parámetros
Argumento |
Descripción |
|---|---|
servername |
Valor proporcionado por el usuario para la opción /server. Ejemplo: teamfoundation2. |
labelname |
Identifica el nombre de la etiqueta que se va a asociar, modificar o quitar de los elementos especificados. |
@scope |
Especifica un directorio del servidor de Control de versiones de Team Foundation en el que el nombre de etiqueta es único. Este parámetro permite crear, administrar, recuperar y eliminar de forma independiente una etiqueta o un conjunto de elementos con etiquetas cuando existen dos etiquetas con el mismo nombre en distintas partes del servidor de Control de versiones de Team Foundation. |
ownername |
Proporciona un valor como DOMAIN\JuanGo o sólo juango para la opción /owner. |
itemspec |
Identifica el archivo o carpeta cuya etiqueta se va a asignar, cambiar o modificar. Para obtener más información acerca de cómo Team Foundation analiza itemspecs para determinar qué elementos se encuentran en ese ámbito, vea Sintaxis de la línea de comandos (Team System). |
versionspec |
Proporciona un valor como c2 para la opción /version. Para obtener más información acerca de cómo Team Foundation analiza una especificación de versión para determinar qué elementos se encuentran en su ámbito, vea Sintaxis de la línea de comandos (Team System). |
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 utilizará para la protección. |
Opción |
Descripción |
|---|---|
/server |
Identifica el servidor de Team Foundation Server. Se requiere esta opción si el comando se invoca desde un directorio no asignado a un área de trabajo. |
/owner |
Especifica el nombre del usuario propietario del área de trabajo. |
/version |
(Opcional) Especifica la versión del archivo o carpeta cuya etiqueta se debe asociar, modificar o quitar. Son valores del conjunto de cambios, como C93. De forma predeterminada, Team Foundation utiliza la versión del área de trabajo base si no se proporciona versionspec. |
/comment |
Agrega o modifica una descripción o comentario para la etiqueta. |
/child |
Identifica cómo tratar elementos que tienen etiquetas preexistentes que son idénticas a la etiqueta especificada. Utilice Replace para actualizar la versión del elemento que corresponde a la etiqueta existente. Utilice Merge para dejar los elementos únicamente con la etiqueta existente. |
/recursive |
Etiqueta todos los elementos del directorio que coinciden con itemspec y versionspec. No se puede combinar con la opción /delete. |
/delete |
Quita la etiqueta. |
Comentarios
Una etiqueta es un marcador que puede asociar a un conjunto de archivos no relacionados y carpetas en el servidor de Control de versiones de Team Foundation. Use la etiqueta para simplificar la recuperación en un área de trabajo con fines de desarrollo o de compilación. Por consiguiente, una etiqueta es similar a un conjunto de cambios o una fecha y hora en los que se pueden agregar y quitar arbitrariamente archivos y carpetas o cambiar las versiones de los elementos que contienen. Una etiqueta es una especificación de la versión que se puede pasar a los comandos de Team Foundation siguientes:
Los tipos comunes de etiquetas son las etiquetas de etapas como "M1", "Beta2" o "Release Candidate 0".
Las etiquetas son específicas de la versión, es decir, sólo se puede asociar 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 control de versiones; por consiguiente, no se realiza el seguimiento del historial de etiquetas de los archivos. Además, una operación de etiqueta no crea un cambio pendiente en su área de trabajo. Al ejecutar el comando label, la actualización se refleja inmediatamente en el servidor de Control de versiones de Team Foundation.
Para obtener más información sobre cómo encontrar la utilidad de la línea de comandos tf, vea Comandos de la utilidad Tf de la línea de comandos.
Quitar y eliminar etiquetas
Puede utilizar el Comando unlabel para quitar una etiqueta de un archivo o carpeta. También puede eliminar una etiqueta 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 dicha etiqueta, su comentario, ámbito y propietario, vea Comando labels.
Administrar etiquetas sobrecargadas
Los nombres de etiquetas deben ser únicos en todo el ámbito especificado. Cuando agregue una etiqueta, reserve el uso de ese nombre de etiqueta únicamente para el ámbito especificado o implícito. El valor predeterminado del parámetro @scope es el proyecto de equipo, como $/ProyectoDeEquipo1.
Si otro equipo o usuario agrega una etiqueta común como "M3" a un conjunto de archivos con control de versiones en una parte diferente del servidor de Control de versiones de Team Foundation, puede aplicar la etiqueta M3 a los archivos con control de versiones siempre que las carpetas de proyecto raíz estén en directorios diferentes. Por ejemplo, si se ha asignado la etiqueta "M3" a los archivos del directorio $/math, puede aplicar "M3" a los archivos de su directorio $/projects.
Para obtener o quitar una etiqueta, o administrar de otra forma los elementos que tienen la etiqueta M3, debe especificar el parámetro @scope para indicar a Team Foundation con qué etiqueta M3 desea trabajar.
Puede impedir que otros usuarios "sobrecarguen" una etiqueta como "M3" en diferentes partes del servidor de Control de versiones de Team Foundation creando una etiqueta en la raíz ($/) del servidor de Control de versiones de Team Foundation o ajustando los permisos Etiqueta de determinadas carpetas.
Utilizar la opción /child para evitar errores de etiquetado
Si emite un comando label junto con un nombre de etiqueta preexistente y un itemspec que incluye archivos ya marcados con la misma etiqueta, el valor de la opción /child determina si los archivos marcados se deben actualizar con la nueva información de revisión. Es decir, los archivos se etiquetan con el mismo nombre, pero tienen ámbitos diferentes.
Por ejemplo, suponga que tiene una carpeta denominada c:\projects que contiene dos archivos, 314.cs y 271.cs. Suponga también que la versión C70 de 314.cs tiene la etiqueta "ready" (listo). La última versión de 314.cs es la versión C93. Si aplica una etiqueta "ready" a la última versión de la carpeta y los archivos que contiene utilizando el comando siguiente, la etiqueta "ready" se mueve de 314.cs;C70 a 314.cs;C93:
tf label ready c:\projects /recursive /version:T /child:Replace
Sin embargo, si no desea mover la etiqueta "ready" existente de la versión C70 a la versión C93 de 314.cs, debe utilizar la sintaxis siguiente:
tf label ready c:\projects /recursive /version:T /child:Merge
Cuando especifica Merge como valor de la opción /child, las instancias preexistentes de la etiqueta emitida quedan solas.
.gif "Nota") Nota: |
|---|
T es la abreviatura de "Tip" (sugerencia) que sirve para obtener la última versión de versionspec en los dos ejemplos anteriores. |
Ejemplos
El ejemplo siguiente asocia la etiqueta "goodbuild" (versión buena) a la versión en el área de trabajo de la carpeta "docs" y los archivos y carpetas que contiene.
c:\projects>tf label goodbuild docs /recursive
El ejemplo siguiente asocia la etiqueta "goodbuild" a la carpeta "docs", pero no a los archivos y carpetas que la carpeta contiene.
c:\projects>tf label goodbuild docs
En el ejemplo siguiente se asocia la etiqueta "goodbuild" (compilación correcta) a la versión 3 de 314.cs en el servidor de Control de versiones de Team Foundation.
c:\projects>tf label goodbuild /version:3 $/src/314.cs
En el ejemplo siguiente se elimina la etiqueta "badbuild" (compilación incorrecta) de todos los elementos del servidor de Control de versiones de Team Foundation.
c:\projects>tf label /delete badbuild
El ejemplo siguiente utiliza la opción de ámbito para aplicar una etiqueta a 314.cs.
c:\projects>tf label goodbuild@$/TeamProject1 314.cs
Vea también
Tareas
Tutorial: Funciones avanzadas del control de versiones
Conceptos
Referencia
Sintaxis de la línea de comandos (Team System)