Register-NCache
Note
This feature is only available in NCache Enterprise and Professional editions.
Register-NCache command enables the user to activate/reactivate license, or extend evaluation for NCache either online or offline.
Register-NCache [-Key] [-Environment] [-Clients] [-Email] [-FirstName] [-LastName] [-Company] [-Address] [-City] [-State] [-ZipCode] [-Country] [-Phone] [-Reactivate] [-AuthCode] [-Server] [-Port] [-NoLogo] [-Password] [-UserId] [-KeyType] [-OfflineActivate] [<CommonParameters>]
These properties are explained in detail in the Properties section.
Examples
- This command activates NCache on local server with the given Server-Only license key for Production environment.
Register-NCache -Key xxxxxxxxx-xxxxxx-xxxxxxxx -Environment Production -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name
- This command activates NCache on server 20.200.20.29 with the given Client-Server license key for Production environment with 4 client licenses.
Important
Client Server licensing:
For Client-Server licensing, you also need to specify the Client Licenses to activate on cache server.
Register-NCache -Key xxxxxxxx-xxxxxx-xxxxxxxx -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name -Server 20.200.20.29 -Environment Production -Clients 4
- This command reactivates NCache on an already activated machine using the NCache license key.
Register-NCache -Key xxxxxxxx-xxxxxx-xxxxxxxx -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name -Server 20.200.20.29 -Environment Production -Clients 4 -Reactivate
- This command returns the Activation Request Code URL for registering NCache offline using the NCache license key.
Register-NCache -Key xxxxxxxxx-xxxxxx-xxxxxxxx -Environment Production -Clients 6 -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name -OfflineActivate
- This command registers NCache on a local server with the given
AuthCodereceived from Alachisoft.
Register-NCache -AuthCode xxxxxxxxxxxxxx -OfflineActivate
Tip
Reactivate NCache License:
You can reactivate NCache online/offline by specifying the Reactivate parameter in the Register-NCache command.
Register-NCacheallows you to extend the evaluation period for 30 days by specifying theKeyTypeparameter asExtension. This command extends the domain-specific evaluation of NCache for 30 days using the given extension key.
Register-NCache -Key xxxxxxxxxxxxx -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name -KeyType Extension
Properties
Note: The parameters with asterisk (*) on their names are required parameters and the rest are optional.
| Parameters | Data Types | Description | Default Value |
|---|---|---|---|
-Key* |
<String> |
Specifies the license key received from Alachisoft. | - |
-Environment* |
<String> |
Environment name for which the machine is being activated. Only required at the time of activation/reactivation. | - |
-Clients* |
<Int> |
Number of client licenses to be activated with the specified environment. Only required at the time of activation/reactivation for Client-Server Licensing. | - |
-FirstName* |
<String> |
Specifies user's first name to be registered. | - |
-LastName* |
<String> |
Specifies user's last name to be registered. | - |
-Email* |
<String> |
Specifies user's Email ID to be registered. | - |
-Company |
<String> |
Specifies user's company name to be registered. | - |
-Address |
<String> |
Specifies user's address to be registered. | - |
-City |
<String> |
Specifies user's city to be registered. | - |
-State |
<String> |
Specify user's state to be registered. | - |
-Zip Code |
<String> |
Specifies user's Zip Code to be registered. | - |
-Country |
<String> |
Specifies user's country name to be registered. | - |
-Phone |
<String> |
Specifies user's phone number to be registered. | - |
-Reactivate |
<SwitchParameter> |
Represents reactivation of given license. | - |
-OfflineActivate |
<SwitchParameter> |
Represents offline activation/reactivation of a given license or extension of evaluation. When this switch is used, the command generates an "Activation/Extension Request Code URL". Copy this URL to another computer with an internet access, open that URL to obtain "Activation/Extension Authorization Code". Copy that code to the machine you are trying to activate/extend the evaluation for and complete your activation/reactivation or extension. | - |
-AuthCode* |
<String> |
Auth code is generated from the URL which is obtained when Register-NCache command is executed with the OfflineActivate parameter |
- |
-Server |
<String> |
Specifies server name or IP address | IP of local machine |
-Port |
<Long> |
Specifies the server port where NCache service is listening. | 8250 |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. | False |
-UserId (Enterprise edition only) |
<String> |
Specifies the UserId that is used to authorize the user if security is enabled on the cache server. This UserId must be same as the active directory user credentials. | - |
-Password (Enterprise edition only) |
<String> |
Specifies the password for user authorization if security is enabled on cache server. This password must be the same as active directory password. | - |
-KeyType |
<String> |
Specifies whether the given key is either an 'Extension' key or a 'License' key. | License |
<CommonParameters> |
<CommonParameters> |
This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters. | - |