New-OVApplianceStaticRoute

Syntax

New-OVApplianceStaticRoute
    [-Destination] <String>
    [-Gateway] <IPAddress>
    [-Interface] <String>
    [-Metric <int>]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

Description

When configuring a second NIC on a virtual machine appliance, static routes can be configured as only a single appliance NIC can be configured with a default gateway. Both IPv4 and IPv6 static routes are supported. Use Get-OVApplianceIPAddress to display the configured NIC interfaces, and supply the interface name with the -Interface parameter.

Info

Minimum required privileges: Infrastructure administrator

Examples

Example 1

New-OVApplianceStaticRoute -Destination 192.168.199.9/24 -Gateway 192.168.33.1 -Interface SecondNIC

Add the specific IPv4 static route to an appliance.

Example 2

New-OVApplianceStaticRoute -Destination 2001:db8:abcd:0012::0/64 -Gateway 2001:db8:85a3:0000:0000:8a2e:0370:7334 -Interface SecondNIC

Add the specific IPv6 static route to an appliance.

Parameters

-ApplianceConnection <Object>

Specify one or more [HPEOneView.Appliance.Connection] object(s) or Name property value(s).

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

Aliases	Appliance
Required?	False
Position?	Named
Default value	(${Global:ConnectedSessions} \| ? Default)
Accept pipeline input?	false
Accept wildcard characters?	False

-Destination <String>

IP Address of the destination subnet. Format must follow {address}/{bits}. Can either be IPv4 or IPv6 address type.

Aliases	None
Required?	True
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Gateway <IPAddress>

The IP address of the router. Can either be an IPv4 or IPv6 address, but must match the type provided in the -Destination parameter.

Aliases	None
Required?	True
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Interface <String>

Interface name of the NIC the static route will be configured for.

Aliases	None
Required?	True
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Metric <int>

Route weight value if multiple next hop routes will be configured for the same subnet. If no value provided, the route weight will be set to 100.

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

None. You cannot pipe objects to this cmdlet.

Return Values

HPOneView.Appliance.TaskResource [System.Management.Automation.PSCustomObject]

Async task resource to monitor.