im addlabel
adds a label to an issue based on a current or historical date
Synopsis
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...
Description
im addlabel assigns a label to a PTC RV&S issue.
Options
This command takes the universal options available to all
im commands, as well as some general options. See the
options reference page for descriptions.
• --[no]movelabel
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
• --asOf=[<date>|label:<label>]
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.
• --comment=value
specifies a comment to associate with the label.
• -L label
• --label=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