Assigns a label to the specified version or current version of a file or project.
ss Label VSS items [-C] [-H] [-I-] [-Llabel] [-N] [-O] [-V] [-Y] [-?]
Assigns a label to the current version of the current project:
ss Label
Assigns a label to the current version of the project $/WORD:
ss Label $/WORD
Assigns a label to version 5 of the file HELP.C:
ss Label HELP.C -V5
The following table describes the command-line options available with this command.
Option | Description |
-C | Use the same comment for all labels. |
-V | Label an existing file or project version. |
-L | Specify the new label on the command line (instead of being prompted). |
-O | Paginate or redirect the command output. |
-I- | Ignore: Do not ask for input under any circumstances. |
-N | Change between long and short file name mode. |
-Y | Specify a username and/or password. |
-?, -H | Request online Help on a command. |
You must have the Add access right to use this command.
The Label command creates a new version of the specified project or file, and assigns your label to that version. However, if you use the -V option to refer to a specific version, the label is simply applied to that version.
If you assign a label to a version that already has a label, or if you assign a label to an item that already uses that label for a different version, the old label is replaced. In either case, VSS issues a warning before replacing the old label.
If you specify multiple items on the command line, VSS prompts you for a different label for each item. The -C option asks for only one label, which VSS applies to all the items you have listed. The -L option bypasses the label prompt entirely by specifying the label on the command line, for example, -L2.00b.