CLI Reference > Configuration Management Commands > si promote
si promote
promotes the state of a member
si promote [(-r rev|--revision=rev)] [(-s state|--state=state)] [(-R|--[no|confirm]recurse)] [--filter=filteroptions] [(-P project|--project=project)] [--[no]failOnAmbiguousProject] [(-S sandbox|--sandbox=sandbox)] [--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...
si promote promotes a project member 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.
At particular milestones, project members are ready to move to the next state of their development cycle (for example, from Development to Testing). This is done through states and their promotion.
Promoting members 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.
specifies the target state to be set for the promoted member. If no state is specified, the member is promoted to the next state.
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 demote, si demoteproject, si promoteproject
Miscellaneous: ACL, diagnostics, options, preferences