si exportsandbox
exports a sandbox to a file
Synopsis
si exportsandbox [--exportFiles=[none|members|all]] [--[no|confirm]overwriteExisting] [--targetFile=value] [(-S sandbox|--sandbox=sandbox)] [(-?|--usage)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]]
Description
si exportsandbox exports a sandbox to a file with the extension .pjx. This command also works for Sandboxes in scenarios where the corresponding project no longer exists or the server no longer exists.
The following are possible uses for exporting sandboxes:
• Exported sandboxes can be distributed to users to save them time and effort creating them.
• Exporting a sandbox and then importing it into other clients can reduce network traffic for large file sets rather than creating a new sandbox.
• Exporting a sandbox can be a way to duplicate the sandbox and retarget it to another development path.
• Exported sandboxes can be part of a client upgrade strategy, to stagger the impact of the upgrade on work.
• An exported sandbox can be used as part of troubleshooting an issue with technical support.
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.
• --exportFiles=[none|members|all]
specifies the files to include in the exported Sandbox.
◦ none
specifies not to include working files.
◦ members
specifies to only include working files that correspond to members. Note that former members and deferred operations are also included.
◦ all
specifies to include all working files located in the corresponding Sandbox directory, even if the files do not correspond to members.
• --[no|confirm]overwriteExisting
specifies whether or not to overwrite an existing .pjx file.
• --targetFile=value
specifies the filename for the exported Sandbox, with the file extension .pjx. The default location is the root of the corresponding Sandbox directory.
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