CLI Reference > Configuration Management Commands > si movesandbox
si movesandbox
moves a top level Sandbox to a new location
si movesandbox [(-S sandbox|--sandbox=sandbox)] [--[no]confirm] [--[no]overwrite] [--targetDir=value] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=value] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|actions|default]]
You can move a top level Sandbox, and all of its members, subsandboxes, and associated metadata to another location. Moving a Sandbox performs a Sandbox retarget operation followed by a Sandbox move or rename operation. After a Sandbox move operation:
Everything in the current directory and subdirectories is moved, including non members and work-in-progress files,
The target Sandbox retains its configuration type (normal, variant, build), and
All deferred change package entries will be updated with the new Sandbox name.
Before using si movesandbox, note the following:
Moving a Subsandbox or multiple Sandboxes is not supported.
When you move a Sandbox, the command creates the target directory if it does not already exist on disk.
The operation will fail if you have locks on members in the Sandbox. Use the si locks command to find and address locked members, and then run the si movesandbox command again.
When performing a Sandbox move operation, Windchill RV&S performs a Sandbox retarget operation before moving the files on disk. If the Sandbox move operation fails due to file system issues (such as directory permissions), you can correct the file system issue and move the Sandbox contents manually. You can also resychnronize the target Sandbox; however, resynchronizing can overwrite work-in-progress files.
The following is an example of the command syntax:
si movesandbox --confirm --sandbox=c:/Aurora_Program/CurrentModel/project.pj
This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.
-S sandbox
specifies the location of a Sandbox. This option is required. Locations that include spaces must be enclosed by quotes.
controls whether to confirm the move before proceeding.
controls whether to overwrite the target directory if it exists and is not empty.
specifies the top level root Sandbox destination directory. This option specifies the Sandbox folder itself and does not specify the Sandbox container directory. You cannot specify a target directory that is already registered as a Sandbox or a Subsandbox.
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 configuresandbox, si dropsandbox, si move
Miscellaneous: ACL, diagnostics, options, preferences