Unlabel command (Team Foundation Version Control)

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

Visual Studio 2019 | Visual Studio 2022

The Team Foundation Version Control (TFVC) unlabel command removes an item from an existing label in the version control server.

Prerequisites

To use the unlabel command, you must either own the label, or have the Administer labels permission set to Allow. For more information, see Default TFVC permissions.

Syntax

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

Parameters

The following sections describe arguments and options of the unlabel command.

Arguments

Argument

Description

<team-project-collection-url>

Specifies the URL of the project collection that contains the item that you want to remove from an existing label, for example, https://myserver:8080/tfs/DefaultCollection.

<label-name>

Specifies the name of the label to remove from the specified items.

<item-specification>

Identifies the file or folder to remove the specified label from. For more information about how TFVC parses item specifications to determine which items are within scope, see Use Team Foundation version control commands.

Note

You can specify more than one item specification argument.

<username>

Provides a value to the /login option. You can specify this value as either DOMAIN\<username> or <username>.

<password>

Provides a value to the /login option.

Options

Option Description
/recursive Removes the specified label from all items in the particular directory and all subdirectories that match the item specification.
/collection Specifies the project collection.
/login Specifies the username and password to authenticate the user with Azure DevOps.

Remarks

The unlabel command of the tf command-line utility removes an item from an existing label in the Azure DevOps server. For an introduction to labels, see Use labels to take a snapshot of your files. For information about how to assign a label to a set of files and folders, see Label command (Team Foundation Version Control).

If you remove all items from a label in the Azure DevOps server, that label is deleted. You can also delete a label by using the tf label /delete command. To learn more about the existing labels in the system, see Labels command.

For more information about how to use the tf command-line utility, see Use Team Foundation version control commands.

Examples

The following example removes the goodbuild label from 314.cs:

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

The following example removes the Beta1 label from all files and folders in the collection at https://myserver:8080/tfs/DefaultCollection:

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