CLI Reference > Configuration Management Commands > si addlabel
si addlabel
assigns a label to project members
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...
siaddlabel assigns a label to a revision of one or more members of a Windchill RV&S 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.
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
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.
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.
identifies a specific member; use spaces to specify more than one member.
See the diagnostics reference page for possible exit status values.
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