CLI Reference > Configuration Management Commands > si promoteproject
si promoteproject
promotes the state of a project
si promoteproject [--[no|confirm]force] [(-s state|--state=state)] [(-P project|--project=project)] [--[no]failOnAmbiguousProject] [(-S sandbox|--sandbox=sandbox)] [--devpath=path] [--projectRevision=rev] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]]
si promoteproject promotes a project to a higher state of development. A state is a textual description, defined by the administrator, used to classify the condition of a revision in a history. If no state is assigned to a revision at check-in, a default value of Exp (for Experimental) is used. See the Windchill RV&S Help Center for details on setting up states.
Just as you can with a project member, you can promote the project itself (change its state, in other words). This can assist in management of an entire project through a development cycle, especially if the promotion functions are restricted to key project personnel. Normally, you promote a project (set its state) when you si checkpoint it, but you can do so at any time. Only the project is promoted, not the members of the project.
Promoting projects is for historical purposes only. To more effectively control project workflow, PTC recommends using the Windchill RV&S integration.
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 to force promotion of a project even if members have been changed.
-s state
specifies the target state to be set for the promoted project. If no state is specified, the project is promoted to the next state.
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 demote, si demoteproject, si promote
Miscellaneous:ACL, diagnostics, options, preferences