CLI Reference > Configuration Management Commands > si dropsandbox
si dropsandbox
drops a Sandbox
si dropsandbox [--[no]confirm] [--delete=[none|members|all]] [-f] [(-?|--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]] sandbox location...
si dropsandbox unregisters a Sandbox from the Windchill RV&S Client. For example,
si dropsandbox --confirm --delete=none c:/Aurora_Program/project.pj
Once a Sandbox is dropped, Sandbox commands do not operate on the Sandbox.
Dropping a Sandbox is permanent. Even if you do not delete the Sandbox files, you cannot import the Sandbox again.
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 the display of confirmation messages. -f forces an action without any prompt.
deletes files from the client Sandbox directory according to the value specified. If none is specified, then no deletion occurs after the Sandbox is dropped. If members is specified, then the specified Sandbox, sub Sandboxes, and members are deleted. If all is specified, then everything in the current directory and subdirectories is deleted. For example:
--delete=none sandbox.pj
causes sandbox.pj to be removed from the registry, but not deleted from the client directory.
--delete=members sandbox.pj
causes sandbox.pj to be removed from the registry and deleted from the client directory along with all its sub Sandboxes and members.
--delete=all sandbox.pj
causes sandbox.pj to be removed from the registry and all files in the client directory and subdirectories to be deleted.
Since --delete=all is a destructive operation, it always requires confirmation. This is a preventative security measure. For example, if you create a Sandbox in the root of a file system, this operation would delete your entire drive.
sandbox location...
identifies the location of a specific Sandbox; use spaces to specify more than one Sandbox.
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 createsandbox, si importsandbox, si sandboxes, si viewsandbox
Miscellaneous: diagnostics, options, preferences