Remove HPOVLicense

Library Version 3.00

Library Version 2.00

Library Version 1.20

### HPE OneView 3.00 Library

Remove-HPOVLicense

REmove installed licenses on the appliance.

SYNTAX

Remove-HPOVLicense [-InputObject] <Object> [-ApplianceConnection] <Object>[ [-WhatIf] <SwitchParameter>][ [-Confirm] <SwitchParameter>] [<CommonParameters>]

Detailed Description

This Cmdlet will remove licenses installed on the appliance. Removing installed licenses is only support via Windows PowerShell, Python or the HPE OneView REST API. However, if a license key is currently assigned to a resource, the license key cannot be removed.

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s). If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases	Appliance
Required?	true
Position?	named
Default value	(${Global:ConnectedSessions} | ? Default)
Accept pipeline input?	true (ByPropertyName)
Accept wildcard characters?	False

-Confirm <SwitchParameter>

Aliases	cf
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-InputObject <Object>

Aliases [-uri, -name, -License]

Provide the License URI or object to remove.

Aliases	uri, name, license, Resource
Required?	true
Position?	named
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-WhatIf <SwitchParameter>

Aliases	wi
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

System.Management.Automation.PSCustomObject HPE OneView License object

Return Values

System.Management.Automation.PSCustomObject nSuccess message _**System.Management.Automation.ErrorRecord**_ nError message of in-use license key

Examples

 -------------------------- EXAMPLE 1 --------------------------

PS C:\> $LicenseKeys = Get-HPOVlicense
PS C:\> Remove-HPOVLicense $LicenseKeys[0]

Get all installed licenses saving them to $LicenseKeys, then calling Remove-HPOVLicense to remove the first key in the variable.

 -------------------------- EXAMPLE 2 --------------------------

PS C:\> Get-HPOVlicense | Remove-HPOVLicense

Get all installed licenses and remove them.

Related Links

• [Get-HPOVLicense] (https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVLicense)
• [New-HPOVLicense] (https://github.com/HewlettPackard/POSH-HPOneView/wiki/New-HPOVLicense)

---

Top

### HPE OneView 2.00 Library

Remove-HPOVLicense

REmove installed licenses on the appliance.

SYNTAX

Remove-HPOVLicense [-Resource] <Object> [-ApplianceConnection] <Object>[ [-WhatIf] <SwitchParameter>][ [-Confirm] <SwitchParameter>] [<CommonParameters>]

Detailed Description

This Cmdlet will remove licenses installed on the appliance. Removing installed licenses is only support via Windows PowerShell, Python or the HPE OneView REST API. However, if a license key is currently assigned to a resource, the license key cannot be removed.

Parameters

-ApplianceConnection <Object>

Aliases [-Appliance]

Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s). If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.

Default Value: ${Global:ConnectedSessions} | ? Default

Aliases	Appliance
Required?	true
Position?	named
Default value	(${Global:ConnectedSessions} | ? Default)
Accept pipeline input?	true (ByPropertyName)
Accept wildcard characters?	False

-Confirm <SwitchParameter>

Aliases	cf
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Resource <Object>

Aliases [-uri, -name, -License]

Provide the License URI or object to remove.

Aliases	uri, name, license
Required?	true
Position?	0
Default value
Accept pipeline input?	true (ByValue)
Accept wildcard characters?	False

-WhatIf <SwitchParameter>

Aliases	wi
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

HPOneView.Appliance.License [System.Management.Automation.PSCustomObject] HPE OneView License object.

Return Values

System.Management.Automation.PSCustomObject `nSuccess message.

System.Management.Automation.ErrorRecord `nError message of in-use license key.

Examples

 -------------------------- EXAMPLE 1 --------------------------

PS C:\> $LicenseKeys = Get-HPOVlicense
PS C:\> Remove-HPOVLicense $LicenseKeys[0]

Get all installed licenses saving them to $LicenseKeys, then calling Remove-HPOVLicense to remove the first key in the variable.

 -------------------------- EXAMPLE 2 --------------------------

PS C:\> Get-HPOVlicense | Remove-HPOVLicense

Get all installed licenses and remove them.

Related Links

• [Get-HPOVLicense] (https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVLicense)
• [New-HPOVLicense] (https://github.com/HewlettPackard/POSH-HPOneView/wiki/New-HPOVLicense)

---

Top

### HPE OneView 1.20 Library

Remove-HPOVLicense

REmove installed licenses on the appliance.

SYNTAX

Remove-HPOVLicense [-license] <license>[ [-WhatIf] <WhatIf>][ [-Confirm] <Confirm>] [<CommonParameters>]

Detailed Description

This cmdlet will remove licenses installed on the appliance. Removing installed licenses is only support via Windows PowerShell, Python or the HP OneView REST API.

Parameters

-license <license>

Provide the License URI or object to remove.

Aliases	None.
Required?	true
Position?	1
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-WhatIf <WhatIf>

Aliases	None.
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

-Confirm <Confirm>

Aliases	None.
Required?	false
Position?	named
Default value
Accept pipeline input?	false
Accept wildcard characters?	false

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

System.Management.Automation.PSCustomObject HP OneView License object.

Return Values

System.String `nSuccess message.

System.Management.Automation.ErrorRecord `nError message of in-use license key.

Examples

 -------------------------- EXAMPLE 1 --------------------------

PS C:\> $LicenseKeys = Get-HPOVlicense
PS C:\> Remove-HPOVLicense $LicenseKeys[0]

Get all installed licenses saving them to $LicenseKeys, then calling Remove-HPOVLicense to remove the first key in the variable.

 -------------------------- EXAMPLE 2 --------------------------

PS C:\> Get-HPOVlicense | Remove-HPOVLicense

Get all installed licenses and remove them.

Related Links

• [Get-HPOVLicense] (https://github.com/HewlettPackard/POSH-HPOneView/wiki/Get-HPOVLicense)
• [New-HPOVLicense] (https://github.com/HewlettPackard/POSH-HPOneView/wiki/New-HPOVLicense)

---

Top