Unlabel Command

Unlabel Command

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2005/.NET Framework 2.0

Other versions are also available for the following:

Visual Studio Team System

Unlabel Command

Removes an item from an existing label in the Team Foundation source control server.

tf unlabel [/server:servername] [/recursive] labelname itemspec

Parameters

Argument	Description
servername	The user-provided value for the /server option. Example: teamfoundation2.
labelname	Specifies the name of the label to remove from the specified items.
itemspec	Identifies the file or folder from which to remove the specified label. For more information about how Team Foundation parses itemspecs to determine which items are within scope, see Command-Line Syntax.

Option	Description
/server	Identifies the Team Foundation Server. This option is required if the command is invoked from a directory that is not mapped to a workspace.
/recursive	Unlabels all items in the particular directory that match the itemspec.

Remarks

The unlabel command of the tf command-line utility removes an item from an existing label in the Team Foundation source control server. For an introduction to labels, see Working with Labels. For information about how to assign a label to a set of files and folders, see Label Command (Team Foundation Source Control).

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

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 teamfoundation2 Team Foundation source control server and deletes the "Beta1" label.

c:\projects>tf unlabel Beta1 $/ /server:teamfoundation2 /recursive

Security

To use the unlabel command, you must either own the label, or have the Administer labels permission set to Allow. For more information, see Team Foundation Server Permissions.

Parameters

Tasks

Reference

Concepts

Other Resources