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 one or more Ethernet, Fibre Channel, or FCoE network resources from the connected HPE OneView appliance.

​
Syntax

Remove-OVNetwork
    -InputObject <Object>
    [-Force]
    [-ApplianceConnection <Object>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

​
Description

Remove-OVNetwork permanently deletes network resources from HPE OneView. The cmdlet raises a confirmation prompt by default because the operation cannot be undone.
Removing a network that is currently referenced by a server profile connection, network set, or uplink set will fail unless those associations are removed first.
Use the -Force switch to suppress dependency validation. Pipeline input is supported, making it straightforward to retrieve a collection of networks and delete them in a single expression. The -WhatIf parameter lets you preview which networks would be deleted without committing the operation.

​
Parameters

​
InputObject
Object
required
The network object(s) to delete. Accepts HPEOneView.Networking.EthernetNetwork, HPEOneView.Networking.FibreChannelNetwork, or HPEOneView.Networking.FCoENetwork objects from Get-OVNetwork. Supports pipeline input. Also accepts a network URI string or resource name string.
​
Force
Switch
Bypass dependency validation and force deletion. Use with caution — forcibly removing a network that is in use can leave server profile connections in an inconsistent state.
​
ApplianceConnection
Object
The appliance connection object or name. Defaults to the default connected session.
​
WhatIf
Switch
Simulate the deletion without making any changes. Displays what would be removed.
​
Confirm
Switch
Prompt for confirmation before each deletion. Enabled by default (ConfirmImpact = High).

​
Examples

​
Remove a specific network (with confirmation prompt)

$net = Get-OVNetwork -Name "yellow" -Type Ethernet
Remove-OVNetwork -InputObject $net

​
Remove a network via the pipeline

Get-OVNetwork -Name "black" -Type Ethernet | Remove-OVNetwork

​
Remove multiple networks without prompting

Get-OVNetwork -Type Ethernet | Remove-OVNetwork -Confirm:$false

​
Preview a deletion without committing

Get-OVNetwork -Name "DirectAttach Fabric A" -Type FibreChannel | Remove-OVNetwork -WhatIf

​
Forcibly remove a network

Get-OVNetwork -Name "Production Fabric B" -Type FibreChannel | Remove-OVNetwork -Force -Confirm:$false

​
Output

None. A task completion message is written to the host.

Build docs developers (and LLMs) love

Get started for freeTalk to us