CLI Reference > Configuration Management Commands > si drop
si drop
drops a member or subproject from a project
si drop [--cpid=ID|--changePackageId=ID] [--[no|confirm]closeCP] [--issueId=ID] [(-f|--[no]confirm)] [--[no]defer] [--[no]delete] [--filter=filteroptions] [--[no]failOnAmbiguousProject] [(-P project|--project=project)] [(-S sandbox|--sandbox=sandbox)] [--devpath=path] [--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... or subproject...
si drop drops specified members and subprojects from a project. For example,
si drop --confirm --nodelete c:/Aurora_Program/bin/Libra/project.pj
Files dropped in a Sandbox are not actually dropped from the Sandbox until you use the si resync command, or if you specify --delete with this command. This allows Sandbox users to be protected from a file deletion until an appropriate point, and therefore be in control.
This command does not operate in a Build Sandbox.
If a member has outlived its usefulness or just does not belong in a project any more, you can remove it at any time. After you remove a member from a project, the member is no longer listed as part of the Sandbox or master project, but the member history remains, in case you need to recreate an earlier version of the project. The build project and variants may still have the file as a member.
Adding a member (see si add) which has previously been dropped will result in the history of the dropped member becoming the history of the newly added member.
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 close the associated change package.
--nocloseCP means do not close the change package.
--confirmcloseCP means ask before closing the change package.
--closeCP always closes the change package.
controls the display of confirmation messages. -f forces an action without any prompt.
controls whether to delay the drop operation in the project until the deferred operation is submitted. The operation in the Sandbox still takes place immediately.
control whether the working file should be deleted immediately from your Sandbox, when using -S or --sandbox.
member... or subproject...
identifies a specific member or subproject; use spaces to specify more than one.
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 add, si closecp, si cpissues, si createcp, si viewcps
Miscellaneous: ACL, diagnostics, options, preferences