si movesandbox
moves a top level Sandbox to a new location
Synopsis
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]]
Description
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, Integrity Lifecycle Manager 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
--targetDir=c:/Aurora_Program/NewModel
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.
• -S sandbox
--sandbox=sandbox
specifies the location of a Sandbox. This option is required. Locations that include spaces must be enclosed by quotes.
• --[no]confirm
controls whether to confirm the move before proceeding.
• --[no]overwrite
controls whether to overwrite the target directory if it exists and is not empty.
• --targetDir=value
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.
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