CLI Reference > Configuration Management Commands > si promote
 
si promote
promotes the state of a member
Synopsis
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...
Description
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 Integrity Lifecycle Manager 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 Integrity Lifecycle Manager integration.
Options
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
-sstate
--state=state
specifies the target state to be set for the promoted member. If no state is specified, the member is promoted to the next state.
member...
identifies a specific member; use spaces to specify more than one member.
Diagnostics
See the diagnostics reference page for possible exit status values.
Preferences
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