1. Home
  2. Docs
  3. Super-ExMerge On-line Doc...
  4. PowerShell Cmdlet Referen...
  5. Export-License

Export-License

Use this cmdlet to export the current Super-ExMerge license to an encrypted file. This exported license file can then be imported onto the host that matches the HostKey provided.

NOTE: Free-use licenses cannot be exported or imported.

Export-License

  • -FileName
  • -HostKey
  • [-ForceOverwrite]


Description

This cmdlet is used to export a paid-use license from the current host. The license can only be exported by providing a HostKey of another host on which the license would be imported.
Exporting a license removes the license from the current host and sets the host into the free-use license model.
Note that if the license is exported, and the target host is lost or unavailable, there will be no way to import the license. Licenses are host-specific.

Examples

Example 1
  Export-License -FileName c:\path\to\folder\filename.lic -HostKey 9a8f78g7s87d78f78gb9jluh7==

This example will export the current paid-use license to the file named ‘filename.lic’. There is no requirement for the filename to have any specific file extension; any file name or extension is valid.

The -HostKey value provided identifies another host that upon which SuperExMerge is already installed.

The HostKey can retrieved using the Show-License cmdlet.


Parameters

-FileName

The FileName parameter specifies the path and filename for the exported license data. If a file already exists, and the -ForceOverwrite parameter is not used, a prompt to overwrite will be presented.

Required:
Yes
Type:
String
Aliases:
None
Position:
0
Default Value:
None

-HostKey

The HostKey parameter uniquely identifies another host upon which the exported license is to be imported.
The HostKey value for a host can be retrieved using the Show-License cmdlet.
NOTE: Entering random data for this property can cause the license to be exported to a bogus HostKey, and will essential disable the license and prevent it from being imported on any other host.

Required:
Yes
Type:
String
Aliases:
None
Position:
1
Default Value:
None

-ForceOverWrite

The ForceOverwrite switch parameter determines whether and existing file with the same name as -FileName is overwritten without a prompt.

Required:
No
Type:
SwitchParameter
Aliases:
None
Position:
2
Default Value:
False

Output

This will place a System.IO.FileInfo object on the pipeline referencing the exported file.

How can we help?