si retargetsandbox
points a Sandbox at a different project configuration
Synopsis
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]]
Description
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.
|
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.
• --[no]openView
controls whether to open the Sandbox view after this Sandbox is retargeted. If --noopenView is used, the Sandbox view does not open.
• --[no]failOnAmbiguousProject
Specifies if to abort command operation when multiple projects correspond to a flat project string.
• --retargetServer
Specifies that the Sandbox use a different Integrity Lifecycle Manager Server (retargets the Sandbox from its existing Integrity Lifecycle Manager Server to another Integrity Lifecycle Manager 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
where
◦ NewServer
is the hostname of the Integrity Lifecycle Manager Server to which the Sandbox is being retargeted.
◦ NewPort
is the port number of the Integrity Lifecycle Manager Server to which the Sandbox is being retargeted.
◦ SandboxPath
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
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
