Comando Unlabel (Control de versiones de Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

El comando unlabel de Control de versiones de Team Foundation (TFVC) quita un elemento de una etiqueta existente en el servidor de control de versiones.

Requisitos previos

Para usar el comando unlabel, debe ser propietario de la etiqueta o tener el permiso Administrar etiquetas establecido en Permitir. Para obtener más información, vea Permisos predeterminados de TFVC.

Sintaxis

tf unlabel [/collection:<team-project-collection-url>] [/recursive] [/login:<username>, [<password>]] <label-name> <item-specification>

Parámetros

En las secciones siguientes se describen los argumentos y las opciones del comando unlabel.

Argumentos

Argument

Descripción

<team-project-collection-url>

Especifica la dirección URL de la colección de proyectos que contiene el elemento que quiere quitar de una etiqueta existente; por ejemplo, https://myserver:8080/tfs/DefaultCollection.

<label-name>

Especifica el nombre de la etiqueta que se va a quitar de los elementos especificados.

<item-specification>

Identifica el archivo o carpeta del que se va a quitar la etiqueta especificada. Para obtener más información sobre cómo TFVC analiza las especificaciones de los elementos 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 de especificación de elementos.

<username>

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

<password>

Proporciona un valor a la opción /login.

Opciones

Opción Description
/recursive Quita la etiqueta especificada de todos los elementos del directorio concreto y todos los subdirectorios que coinciden con la especificación del elemento.
/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 unlabel de la utilidad de línea de comandos tf quita un elemento de una etiqueta existente en el servidor de Azure DevOps. Para obtener una introducción a las etiquetas, vea Uso de etiquetas para hacer una instantánea de los archivos. Para obtener información sobre cómo asignar una etiqueta a un conjunto de archivos y carpetas, vea Comando Label (Control de versiones de Team Foundation).

Si quita todos los elementos de una etiqueta en el servidor de Azure DevOps, esa etiqueta se elimina. También puede eliminar una etiqueta mediante el comando tf label /delete. Para obtener más información sobre las etiquetas existentes en el sistema, vea Comando Labels.

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 quita la etiqueta goodbuild de 314.cs:

c:\projects>tf unlabel goodbuild $/src/314.cs

En el ejemplo siguiente se quita la etiqueta Beta1 de todos los archivos y carpetas de la colección en https://myserver:8080/tfs/DefaultCollection:

c:\projects>tf unlabel Beta1 $/ /collection:https://myserver:8080/tfs/DefaultCollection /recursive