CLI Reference > Configuration Management Commands > si retargetsandbox
si retargetsandbox
points a Sandbox at a different project configuration
si retargetsandbox [--[no]openView] [(-P project|--project=project)] [(-S sandbox|--sandbox=sandbox)] [--devpath=path] [--projectRevision=rev] [--[no]failOnAmbiguousProject] [--retargetServer] [--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]]
si retargetsandbox allows you to point your Sandbox at a different project configuration. For example, a developer can change a variant Sandbox to point to a different variant project, or a buildmaster can change a build Sandbox to point to a different build. You can also change the type of project that the Sandbox points to, for example, you can change a normal Sandbox to point to a variant project.
You can only retarget a Sandbox that contains deferred member operations or locks if you are specifying the --retargetServer option.
You can only retarget top level Sandboxes.
You can only retarget to another type of the same project that the Sandbox is currently pointing to.
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 open the Sandbox view after this Sandbox is retargeted. If --noopenView is used, the Sandbox view does not open.
Specifies if to abort command operation when multiple projects correspond to a flat project string.
Specifies that the Sandbox use a different Windchill RV&S Server (retargets the Sandbox from its existing Windchill RV&S Server to another Windchill RV&S Server). This option can be used when the current server is offline (the new server must be online). This option cannot be specified with --projectRevision or --devpath.
The option takes the following syntax:
si retargetsandbox --retargetServer --hostname=NewServer --port=NewPortSandboxPath
is the hostname of the Windchill RV&S Server to which the Sandbox is being retargeted.
is the port number of the Windchill RV&S Server to which the Sandbox is being retargeted.
is the path to the Sandbox that is being retargeted by the command.
For example:
si retargetsandbox --retargetServer --hostname=production2 --port=7001 C:/Sandboxes/code/project.pj
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 checkpoint, si createdevpath, si createsandbox, si dropsandbox, si importsandbox, si sandboxes, si viewsandbox
Miscellaneous: diagnostics, options, preferences