Register-NCache - PowerShell Cmdlet
This PowerShell Cmdlet enables the user to activate/reactivate licenses, or extend evaluation for NCache, both online or offline.
Important
NCache OSS has different parameters in some Cmdlet instances. Please refer to the seperate Open Source PowerShell Reference to ensure intended working in this case.
Register-NCache [-Key] [-Environment] [-Clients] [-Address] [-City] [-Company] [-Country] [-Email] [-FirstName] [-LastName] [-Phone] [-Reactivate] [-State] [-ZipCode] [-AuthCode] [-Server] [-Port] [-Credentials] [-OfflineActivate] [-KeyType] [-RegisterAs] [-NoLogo]
Examples of Register-NCache - PowerShell Cmdlet
- This PowerShell Cmdlet registers NCache on a 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 PowerShell Cmdlet registers NCache on server 20.200.20.11 with the given Client-Server license key for a 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.11 -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.11 -Environment Production -Clients 4 -Reactivate
- This command activates the NCache image as a Remote Client installation when deploying as a Docker container or on a cloud platform.
Register-NCache -Key xxxxxxxx-xxxxxx-xxxxxxxx -FirstName John -LastName Smith -Email john@yourdomain.com -RegisterAs RemoteClient -Company your_company_name -Server 20.200.20.11 -Environment Production
- This command generates an Activation Request Code URL for offline activation of NCache using NCache license key. Copy this URL to another computer with Internet access, open that URL to obtain "Activation Authorization Code". Copy that Authorization Code to this computer and complete your activation by running the following command.
Register-NCache -Key xxxxxxxx-xxxxxx-xxxxxxxx -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name -Server 20.200.20.11 -Environment Production -OfflineActivate
- This command activates NCache license on local server with the given Authorization Code.
Register-NCache -AuthCode xxxxxxxxxxxxxx -OfflineActivate
- This command extends evaluation of NCache on local server with the given extension key.
Register-NCache -Key xxxxxxxxxxxxx -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name -KeyType Extension
- This command generates an Evaluation Extension Request Code URL for offline evaluation extension of NCache using NCache evaluation extension key. Copy this URL to another computer with Internet access, open that URL to obtain an "Evaluation Extension Authorization Code".
Register-NCache -Key xxxxxxxx-xxxxxx-xxxxxxxx -FirstName John -LastName Smith -Email john@yourdomain.com -Company your_company_name -Server 20.200.20.11 -KeyType Extension -OfflineActivate
- This command extends NCache evaluation on local server with the given Authorization Code.
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.
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* |
<Integer> |
Number of client licenses to be activated with the specified environment. Only required at the time of activation/reactivation for Client-Server (Containerized) Licensing. | - |
-Address |
<String> |
Specifies user's address to be registered. | - |
-City |
<String> |
Specifies user's city to be registered. | - |
-Company |
<String> |
Specifies user's company name to be registered. | |
-Country |
<String> |
Specifies user's country name to be registered. | - |
-Email* |
<String> |
Specifies user's email to be registered. | - |
-FirstName* |
<String> |
Specifies user's first name to be registered. | - |
-LastName* |
<String> |
Specifies user's last name to be registered. | - |
-Phone |
<String> |
Specifies user's phone number to be registered. | - |
-Reactivate |
<SwitchParameter> |
Represents reactivation of given license. | False |
-State |
<String> |
Specifies user's state to be registered. | - |
-Zip Code |
<String> |
Specifies user's zip code to be registered. | - |
-AuthCode* |
<String> |
Auth code is generated from the URL which is obtained when Register-NCache command is executed with the OfflineActivate parameter. This is provided by Alachisoft support department for offline activation |
- |
-Server |
<String> |
Specifies server name or IP address | IP of local machine |
-Port |
<Long> |
Specifies the server port where NCache Service is listening. | 8250 |
-Credentials |
<pscredential> |
Specifies the user credentials required to authorize access for the specified operation. These credentials should belong to a user who has appropriate permissions at the node. | - |
-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. | False |
-KeyType |
<String> |
Specifies whether the given key is either an 'Extension' key or a 'License' key. | License |
-RegisterAs |
<String> |
Specifies the installation type when registering a Docker container or on a cloud image. This parameter is applicable only for Docker or cloud image installations. Acceptable values include 'CacheServer', 'RemoteClient' and 'Developer'. | Cache Server |
-NoLogo |
<SwitchParameter> |
Suppresses display of the logo banner. | True |
