SelectRehost

Use the
selectRehost
command to specify which of the local activations are to be rehosted or returned. This is the first step in the disconnected rehost workflow.
These options are required:
  • 'general --disconnected' specifying the transport data
  • '-sn, --serialnumber'
These parameters are optional:
  • '-b, --binding'
  • '-pv, --productversion'
These options can be included multiple times:
  • '-sn, --serialnumber',
  • '-b, --binding',
  • '-pv, --productversion'
    NOTE:
    • The number of -pv options included must match the number of -sn options.
    • If more than one -b option is included, it must match the number of -sn options. If only one -b option is passed, it applies to all -sn options.
    • If -pv options are included, they must match the number of -sn options.
    • The multiple options are order dependent. The first -sn value is used with the first -b and -pv values. The second -sn value is used with the second -b and -pv values, and so on.
The resulting transport data file includes the necessary rehost data to continue with the next step of the disconnnected rehost workflow. Move the transport data file to the connected computer and use the
updateRehost
command to continue the disconnected rehost workflow.
Usage: selectRehost [options]
This table describes the command options.
Option
Description
-d|--disconnected
Use this required option to support disconnected workflows (get, rehost, and renew). You can specify a file spec for the data transport file. If you do not specify the file spec, a default file spec is used.
Example: '-d:C:\Temp\TransportFile.xml'
Note: '-d C:\Temp\TransportFile.xml' results in a parsing error. You must insert either ':' or '=' when specifying the data transport file.
Note: The file spec must be for an xml file and therefore have an .xml file extension.
-v|--verbose
Use this option to turn on trace messaging.
-f|--forcedOverwrite
Use this option with the -d|--disconnected option. When you include this option, the specified disconnected transport data file will be overwrritten if it exists.
Example: 'getbindings -d:C:\Temp\TransportFile.xml -f'
Note: This option can only be used with the commands getbindings, selectRehost, and writeRenew.
-sn|--serialnumber
Required: The 10-character, alpha-numeric serial number provided in the Activation certificate.
Example: '-sn 5555566778'
-b|--binding
Optional: The binding identifier.
If activations with the same serial number have different bindings, this option determines the specific activation to rehost. If you do not specify a binding identifier, all activations of the given serial number are rehosted.
Example: '-b 3-3519398'
-pv|--productversion
Optional: The product version. This option is only applicable for CodeMeter activations. If CodeMeter activations with the same serial number and binding have different product versions, this option determines the specific CodeMeter activation to rehost. If you do not specify a product version, all activations of the given serial number and binding are rehosted.
Example: '-pv 32.00.00'
-?|-h|--help
Show help information.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.