Unlabel Command
Removes an item from an existing label in the Team Foundation version control server.
Required Permissions
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.
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 (Team System). |
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 and all the subdirectories 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 version 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 Version Control).
If you remove all items from a label in the Team Foundation version 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.
For more information on how to find the tf command-line utility, see Tf Command-Line Utility 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 teamfoundation2 Team Foundation version control server.
c:\projects>tf unlabel Beta1 $/ /server:teamfoundation2 /recursive
See Also
Tasks
Walkthrough: Advanced Functionality of Version Control
Concepts
Reference
Command-Line Syntax (Team System)
Label Command (Team Foundation Version Control)