CLI Reference > Configuration Management Commands > si deleteprojectlabel
si deleteprojectlabel
removes a label from a project
si deleteprojectlabel [(-L label|--label=label)] [(-P project|--project=project)] [(-S sandbox|--sandbox=sandbox)] [--devpath=path] [--projectRevision=rev] [--[no]failOnAmbiguousProject] [--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]] [-R|--[no|confirm]recurse]
si deleteprojectlabel removes a label from a Windchill RV&S configuration management project, deleting the label from whatever project checkpoint the label happens to exist on. For example,
si deleteprojectlabel --label="GA Release" --project=c:/Aurora_Program/bin/Libra/project.pj
The --projectRevision option is not used for identifying the project checkpoint to delete labels from; it is the generic option available on all project-based commands that allows you to specify the checkpoint of the build project you want to work with.
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
-L label
identifies a label. Labels cannot contain colons(:), square brackets ([ ]), or leading spaces. Additionally, they cannot have the same format as a valid revision number.
Labels that include spaces must be enclosed by quotes.
specifies if to recursively delete the label from a project and its subprojects.
The project that the command uses to recurse is the checkpoint where the label is found on the specified project. When performing the recursion, the label is deleted from whichever revision of the subproject the label exists on. Only subprojects that are in this hierarchy are included in the command recursion.
When performing a recursion through the subproject hierarchy, if the label cannot be found, the command continues the recursion.
If the label cannot be deleted, the command stops recursion for that project; consequently the label is not deleted for that project’s child subprojects.
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 addlabel, si addprojectlabel, si deletelabel, si viewlabels
Miscellaneous: ACL, diagnostics, options, preferences