CLI Reference > Configuration Management Commands > si addlabel
 
si addlabel
assigns a label to project members
Synopsis
si addlabel [--[no|confirm]moveLabel] [(-r rev|--revision=rev)] [(-L label|--label=label)] [(-R|--[no|confirm]recurse)] [--filter=filteroptions] [(-P project|--project=project)] [(-S sandbox|--sandbox=sandbox)] [--[no]failOnAmbiguousProject] [--devpath=path] [--projectRevision=rev] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] member...
Description
siaddlabel assigns a label to a revision of one or more members of an Integrity Lifecycle Manager configuration management project. For example:
si addlabel -L Prototype innactivebutton.c

If you do not specify any members, the si addlabel command applies to all project members.
Options
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
--[no|confirm]moveLabel
controls whether the application should move a label from one revision to another.
--nomoveLabel disables the moving of a label.
--confirmmoveLabel displays a confirmation message.
--moveLabel moves the label.
-Llabel
--label=label
identifies a label. To add the label "October 15th Prototype" to a member file activebutton.c, you would enter
si addlabel -L "October 15th Prototype" activebutton.c
Note the following about using labels:
Labels cannot contain colons(:), square brackets ([ ]), or leading spaces.
Labels cannot have the same format as a valid revision number.
Labels that include spaces must be enclosed by quotes.
PTC recommends not using hyphens (-) in labels. Using hyphens may cause some si commands to fail.
Labels cannot contain numbers without any spaces, for example, 14325. Numbers that contain spaces are acceptable, for example, 2432 1234.
member...
identifies a specific member; use spaces to specify more than one member.
Diagnostics
See the diagnostics reference page for possible exit status values.
Preferences
Using si setprefs or si viewprefs, you are able to set or view the preference keys for this command.
See Also
Commands: si addprojectlabel, si ci, si deletelabel, si deleteprojectlabel, si rlog, si viewlabels
Miscellaneous: ACL, diagnostics, options, preferences