Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/HewlettPackard/POSH-HPEOneView/llms.txt

Use this file to discover all available pages before exploring further.

Synopsis

Deletes an existing resource from an HPE OneView appliance by sending an HTTP DELETE to the resource’s URI.

Syntax

Remove-OVResource
    [-InputObject] <Object>
    [-Force]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

Description

Remove-OVResource is a low-level cmdlet that performs an HTTP DELETE on the URI embedded in the resource object ($InputObject.uri). It is the underlying mechanism used by higher-level Remove-OV* cmdlets. The input object must have a .uri property pointing to the resource’s REST URI — all objects returned by Get-OV* cmdlets include this property.
This operation is permanent and cannot be undone. Ensure you have the correct resource before proceeding. Some resources may have dependencies that prevent deletion; use -Force to override dependency checks when supported.

Parameters

InputObject
Object
required
The resource object to delete. Accepts pipeline input. Aliases: Resource, ro, nameOruri, uri, name. Must contain a .uri property.
Force
Switch
Appends ?force=true to the DELETE request URI, allowing deletion of resources that would otherwise be blocked by dependency checks.
ApplianceConnection
Object
The appliance connection object or name. Alias: Appliance. Defaults to the default connection in $ConnectedSessions.

Examples

Delete a resource object

$network = Get-OVNetwork -Name 'Dev-VLAN-200'
Remove-OVResource -InputObject $network

Delete via pipeline

Get-OVNetwork -Name 'Old-Network' | Remove-OVResource

Force deletion

$resource = Get-OVScope -Name 'DeprecatedScope'
Remove-OVResource -InputObject $resource -Force

Delete across multiple appliances

Get-OVNetwork -Name 'TestNetwork' -ApplianceConnection $ConnectedSessions | Remove-OVResource

Output

Returns nothing on success. For asynchronous deletions, returns an HPEOneview.Appliance.TaskResource that can be passed to Wait-OVTaskComplete.

Build docs developers (and LLMs) love