NAME
Activate-DcsLicense
SYNOPSIS
Activates license keys for non-trial licenses.
SYNTAX
Activate-DcsLicense -Keys<String> -Server <Object> -ServerKey <String> -CompanyName <String> -ContactName <String> -EmailAddress <String> -Phonenumber <String> [ -Accept ] [ -LicenseServer <String> ] [ -LicensePort <String> ] [ -Connection <String> ] [ -PipelineVariable <String> ] [ -WhatIf ] [ -Confirm ]
Activate-DcsLicense -GroupKey <String> [ -Capacity <String> ] -CompanyName <String> -ContactName <String> -EmailAddress <String> -Phonenumber <String> [ -Accept ] [ -LicenseServer <String> ] [ -Connection <String> ] [ -PipelineVariable <String> ] [ -WhatIf ] [ -Confirm ]
DESCRIPTION
Activates license keys for non-trial licenses. The cmdlet must be invoked using either ways: single server keys, which requires the server and server keys parameters, server group keys, which requires group keys and capacity parameters or multiple keys, which requires the keys parameters to be provided.
PARAMETERS
- -Keys<String>
- An array of strings that repeats sets of strings, where the first string is a license key and the next string is an optional paramteter based on the specified type of key:
- Group Capacity Key: A data size string, for instance "10 TiB".
- Server key: The server name.
- Other (for instance BZ capacity): none
- The key must be entered in the DataCore Management Console license activation page to view the applicable parameters that a key requires.
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
- -Server<Object>
- ServerHostData object, computer name, or ID that identifies the server. The computer name must be unique or the name must be fully qualified.
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -ServerKey<String>
- The license key to apply to a particular server. The format consists of five groups of five alphanumeric characters separated by hyphens, for instance "ABC1D-E23F4-5GHIJ6-LM78N-ABCDE".
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
- -GroupKey<String>
- The license key to apply to the server group. The format consists of five groups of five alphanumeric characters separated by hyphens, for instance "ABC1D-E23F4-5GHIJ6-LM78N-ABCDE".
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Capacity<String>
- The amount of licensed storage capacity to activate for the group. Use this parameter to activate a portion of the total licensed storage capacity. For instance, if the total licensed capacity is 100 TiB, to activate 50 TiB of that total capacity, enter "50 TiB". The amount must be designated in terabytes.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -CompanyName<String>
- Name of the company.
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -ContactName<String>
- Name of the person designated to communicate with DataCore Technical Support.
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -EmailAddress<String>
- Email address of the contact. A valid format would be "contactname@yourcompany.com".
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Phonenumber<String>
- The phone number of the contact. The valid format includes the area code and hyphens, such as "555-555-5555".
-
- Required: true
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Accept<SwitchParameter>
- Specify this parameter to accept the license term agreements without user interaction when invoking this cmdlet.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -LicenseServer<String>
- This parameter is included as a diagnostic tool for DataCore Technical Support only. Do not use this parameter when invoking the cmdlet.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
- -LicensePort<String>
- A string that is a port number. This parameter is included as a diagnostic tool for DataCore Technical Support only. Do not use this parameter when invoking the cmdlet.
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Connection<String>
- Alias of the connection to the server group. If not specified, the default connection will be used.
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -PipelineVariable<String>
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -WhatIf<SwitchParameter>
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
- -Confirm<SwitchParameter>
-
- Required: false
- Position: named
- Default value:
- Accept pipeline input: false
- Accept wildcard characters: false
-
INPUTS
ServerHostData : Object that identifies the server.
OUTPUTS
NOTES
EXAMPLES
$servers = Get-DcsServer Activate-DcsLicense -Server $servers[1].id -ServerKey XXXXX-XXXXX-XXXXX-XXXXX-XXXXX -CompanyName "Acme Data Storage Co." -ContactName "Sam Administrati" -EmailAddress SANman@acme.com -Phonenumber 555-555-1212 -Accept
Activates a server key for the server group. Company and contact information is provided using parameters. The license term agreement is accepted. The server id is previously acquired with Get-DcsServer and stored in the variable $servers.
Activate-DcsLicense -GroupKey XXXX1-XXXX1-XXXX1-XXXX1-XXXX1 -Capacity "50 TiB" -CompanyName "Acme Data Storage Co." -ContactName "Sam Administrati" -EmailAddress SANman@acme.com -Phonenumber 555-555-1212 -Accept
Activates a server group key for licensed storage capacity. A portion of the total licensed capacity ("50 TiB") is activated by using the parameter Capacity. Company and contact information is provided using parameters. The license term agreement is accepted.