Comando labels (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 labels de Control de versiones de Team Foundation (TFVC) muestra la lista de etiquetas en el servidor TFVC.

Requisitos previos

Para usar el comandolabels, debe tener establecido el permiso Lectura en Permitir para todos los archivos o carpetas a los que se adjunta la etiqueta especificada. Si tiene permiso para algunos, pero no todos los archivos a los que se hace referencia en la etiqueta, se mostrarán resultados parciales. Para más información, vea Permisos predeterminados de TFVC.

Sintaxis

tf labels [/owner:ownername] [/format:(brief|detailed)] 
[/collection:TeamProjectCollectionUrl] [labelname] [/login:username,[password]]

Parámetros

Argumentos

Argument

Descripción

<ownername>

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

<labelname>

Especifica una cadena que se debe usar para filtrar la lista de etiquetas. Si se omite este parámetro, el campo de nombre de etiqueta no se filtrará.

<TeamProjectCollectionUrl>

La dirección URL de la colección de proyectos para la que quiere mostrar la lista de etiquetas, por ejemplo http://myserver:8080/tfs/DefaultCollection.

<username>

Proporciona un valor a la opción /login. Puede especificar un valor username como DOMAIN\username o username.

Opciones

Opción

Descripción

/owner

Especifica el nombre del usuario propietario de la etiqueta. De manera predeterminada, el propietario es la persona que aplica la etiqueta.

/format

Muestra información sobre la etiqueta especificada en uno de los formatos siguientes:

  • Brief: incluye la etiqueta, el propietario y la fecha de creación. Este es el valor predeterminado.
  • Detailed: también incluye comentarios, ámbito y una lista de archivos y carpetas asociados a cada etiqueta.

/collection

Especifica el nombre de la colección de proyectos.

/login

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

Observaciones

  • El comando labels muestra información sobre las etiquetas en el servidor TFVC. Si no especifica un servidor TFVC, TFVC intenta determinarlo mediante el directorio actual. Si el directorio actual no está asignado a un servidor TFVC, debe especificar uno mediante la opción /s.

  • De manera predeterminada, los resultados muestran el nombre de etiqueta, el propietario y la fecha de creación de cada etiqueta. Si el formato se cambia a detailed, también se muestran los comentarios y la lista de archivos y carpetas asociados a cada etiqueta.

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

Ejemplos

En el ejemplo siguiente se muestra la lista de etiquetas creadas por el usuario jasonj.

c:\projects> tf labels /owner:jasonj

En el ejemplo siguiente se muestra información sobre la etiqueta build1033 y se enumeran los archivos y carpetas a los que se ha aplicado la etiqueta en el servidor de TFVC.

c:\projects> tf labels /format:detailed build1033

En el ejemplo siguiente se muestran todas las etiquetas del servidor de TFVC que tienen un elemento labelname que comienza por build y que son propiedad de la cuenta que ejecuta el comando labels.

c:\projects> tf labels build*