CLI Reference > Workflows and Documents Commands > im addlabel
im addlabel
adds a label to an issue based on a current or historical date
im addlabel [--[no]movelabel] [--asOf=[<date>|label:<label>] [--comment=value] [(L=label|--label=label)][--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]] issue id...
im addlabel assigns a label to a Windchill RV&S issue.
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
determines that if the label exists, it can be moved using --asOf. To move the label "Release ABC" to an issue based on a specific time you would enter
im addlabel --movelabel -L "Release ABC" --asOf="January 8, 2007 10:00:00 AM EST" 123
allows you to add or move a label as of a specific date or label. For example, to add the label with a specific date, type
im addlabel -L "Release ABC" --asOf="January 8, 2007 10:00:00 AM EST" 123
If a value is not provided the label is added as of the server's current time. This field is optional.
specifies a comment to associate with the label.
-L label
identifies a label name for an issue. To add the label "Release ABC " to an issue you would enter
im addlabel -L "Release ABC"
issue id...
identifies the ID of the issue(s) associated with the label you want to add or move.
If document versioning is enabled, you can also specify versioned items. To type the ID of a versioned item, use the format Live Item ID-major.minor, for example, 184-1.2.
See Also
Commands: im deletelabel
Miscellaneous: ACL, diagnostics, options, preferences