Comando Etiquetas (Control de versiones de Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019
Visual Studio 2019 | de Visual Studio 2022
El comando de control de versiones de Team Foundation (TFVC) tf labels
muestra la lista de etiquetas en el servidor TFVC.
Prerrequisitos
Para usar el comando labels
, establezca 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 muestran los resultados parciales. Para obtener más información, consulte permisos predeterminados de TFVC.
Sintaxis
tf labels [/owner:ownername] [/format:(brief|detailed)]
[/collection:TeamProjectCollectionUrl] [labelname] [/login:username,[password]]
Parámetros
Argumentos
de argumentos de
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, no se filtrará el campo de nombre de etiqueta.
<TeamProjectCollectionUrl>
Dirección URL de la colección de proyectos para la que desea 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 de username
como DOMAIN\username
o username
.
Opciones
de opción de
descripción
/owner
Especifica el nombre del usuario que posee la etiqueta. De forma predeterminada, el propietario es la persona que aplica la etiqueta.
/format
Muestra información sobre la etiqueta especificada en uno de los siguientes formatos:
-
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 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 determinar el servidor TFVC mediante el directorio actual. Si el directorio actual no está asignado a un servidor TFVC, debe especificar uno mediante la opción/s
.De forma predeterminada, los resultados muestran el nombre de la 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 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.
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 TFVC.
c:\projects> tf labels /format:detailed build1033
En el ejemplo siguiente se muestran todas las etiquetas del servidor TFVC que tienen un labelname
que comienza por build
y son propiedad de la cuenta que ejecuta el comando labels
.
c:\projects> tf labels build*