New HPOVNetwork - HewlettPackard/POSH-HPEOneView GitHub Wiki

Creates one or more new Ethernet or Fibre-Channel networks on the appliance.

New-HPOVNetwork [-Name] <String> [-Type] <String> [-VlanId] <Int32>[ [-NetworkSet] <Object[]>] [-Subnet] <Object> [-VLANType] <String> [-Purpose] <String> [-SmartLink] <Boolean> [-PrivateNetwork] <Boolean> [-TypicalBandwidth] <Int32> [-MaximumBandwidth] <Int32>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

New-HPOVNetwork [-Name] <String> [-VlanRange] <String> [-Type] <String> [-VLANType] <String> [-Purpose] <String> [-SmartLink] <Boolean> [-PrivateNetwork] <Boolean> [-TypicalBandwidth] <Int32> [-MaximumBandwidth] <Int32>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

New-HPOVNetwork [-Name] <String> [-Type] <String> [-VlanId] <Int32> [-TypicalBandwidth] <Int32> [-MaximumBandwidth] <Int32> [-ManagedSan] <Object>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

New-HPOVNetwork [-Name] <String> [-Type] <String> [-TypicalBandwidth] <Int32> [-MaximumBandwidth] <Int32> [-LinkStabilityTime] <Int32> [-AutoLoginRedistribution] <Boolean> [-FabricType] <String> [-ManagedSan] <Object>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

New-HPOVNetwork [-ImportFile] <String>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

Create a new network resource, including its default connection type. Network definitions can be supplied as direct CmdLet parameters or as input from a file containing the network definition in JSON format.

To create an Ethernet Network for Image Streamer, use the following paramters:

* Name
* VlanType = Untagged
* IPv4Subnet Object
* Purpose = Management

-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

-Async <SwitchParameter>

Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.

-AutoLoginRedistribution <Boolean>

Used for login balancing when logins are not distributed evenly over the Fibre Channel links (for example, when an uplink that was down becomes available).

True: Login redistribution is initiated automatically when the link stability time expires. False: Login redistribution must be initiated manually.

This parameter is not applicable for Direct Attach Fabric Types.

-FabricType <String>

Valid values are DirectAttach and FabricAttach. Defaults to FabricAttach

-ImportFile <String>

Full path and file name of a JSON formatted input file containing network definitions.

-LinkStabilityTime <Int32>

The time in seconds the appliance waits before reconnecting to a link that was previously offline (Login redistribution). This interval prevents connection loss due to reconnecting to a link that is unstable (going online and offline repeatedly).

-ManagedSan <Object>

Managed SAN Object or Name.

-MaximumBandwidth <Int32>

Maximum amount of bandwidth to assign, specified in Mbps. Default value is 10000.

-Name <String>

Required object to provide a display name for the network being created. If specifying the -VlanRange parameter, this will become the Nework Name Prefix (i.e. "VLAN" will become "VLAN-[vlanid]".)

-NetworkSet <Object[]>

Specify one or more network set objects the network should be added to during creation from Get-HPOVNetworkSet.

-PrivateNetwork <Boolean>

Default value is FALSE.

-Purpose <String>

A description of the network"s role within the logical interconnect. Accepted values in string format are:

* General
* Management
* VMMigration
* FaultTolerance
* iSCSI

-Scope <HPOneView.Appliance.ScopeCollection>

Provide an HPOneView.Appliance.ScopeCollection resource object to initially associate with. Resource can also be added to scope using the Add-HPOVResourceToScope Cmdlet.

-SmartLink <Boolean>

Default value is TRUE.

-Subnet <Object>

An IPv4 Subnet Object that will be associated with a specific Ethernet Network and VLAN.

-Type <String>

Required value that specifies the type of Network Resource to create. Allowed values are:

* Ethernet
* FC
* FibreChannel
* FCoE

-TypicalBandwidth <Int32>

Preferred amount of bandwidth to assign, specified in Mbps. Default value is 2500.

-VLANType <String>

The type of VLAN configuration for the Ethernet Network. This setting is only applicable for the Uplink Set configuration, and not the Network Set it could be assigned to. Accepted values are

* Tagged
* Tunnel
* Access

Default value is Tagged.

-VlanId <Int32>

The Virtual LAN (VLAN) identification number assigned to the network. The VLAN ID must be unique. The VLAN ID cannot be changed once the network has been created.

When creating an Ethernet Network on an HPE Synergy Composer, Vlan ID 1 is not a valid ID. The allowed range is 2-4095.

-VlanRange <String>

VLAN Range of networks to create. Can be consecutive, non-consecutive or a combination of both.

e.g. -VLANRange "10-90,94,96,200-210"

<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)

HPOneView.Storage.ManagedSan [System.Management.Automation.PSCustomObject]

ManagedSan resource object to be assigned to a FC or FCoE Network

System.Collections.ArrayList

A custom status object or array of objects containing the following PsCustomObject keys:

• Name - name of the network object attempted to be created * Status - status of the creation attempt (Failed for http error return; Complete if a task object is returned)
• Description - Task object or Error object * Exception - System.Management.Automation.ErrorRecord object of the error generated

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

New-HPOVNetwork -type Ethernet -name MyNetwork1 -vlanid 100 -typicalbandwidth 5000 -maximumbandwidth 7500

Creates new Ethernet Network type, with "MyNetwork1" name, VLAN ID 100, and specifies preferred bandwidth to 5Gb/s and max to 7.5Gb/s. Network will be created on all connected appliances.

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

New-HPOVNetwork -type Ethernet -name MyNetwork1 -vlanid 100 -typicalbandwidth 5000 -maximumbandwidth 7500 -Appliance MyAppliance

Creates new Ethernet Network type, with "MyNetwork1" name, VLAN ID 100, an dspecifies preferred bandwidth to 5Gb/s and max to 7.5Gb/s to be created on "MyAppliance"

 -------------------------- EXAMPLE 3 --------------------------

$Connection1 = Connect-HPOVMgmt MyAppliance1.domain.local Administrator MyPassword
$Connection2 = Connect-HPOVMgmt MyAppliance2.domain.local Administrator MyPassword
New-HPOVNetwork -type Ethernet -name MyNetwork1 -vlanid 100 -typicalbandwidth 5000 -maximumbandwidth 7500 -Appliance $Connection1,$Connection2

Creates new Ethernet Network type, with "MyNetwork1" name, VLAN ID 100, an dspecifies preferred bandwidth to 5Gb/s and max to 7.5Gb/s to be created on "MyAppliance1" and "MyAppliance2" using the connection objects.

 -------------------------- EXAMPLE 4 --------------------------

10,20,30,40,50,60 | % { New-HPOVNetwork -type Ethernet -name "VLAN $_" -vlanid $_ }

Create multiple Ethernet Networks.

 -------------------------- EXAMPLE 5 --------------------------

10,20,30,40,50,60 | % { New-HPOVNetwork -type Ethernet -name "VLAN $_-A" -vlanid $_ }
10,20,30,40,50,60 | % { New-HPOVNetwork -type Ethernet -name "VLAN $_-B" -vlanid $_ }

Create Ethernet Networks for an Active/Active configuration.

 -------------------------- EXAMPLE 6 --------------------------

New-HPOVNetwork -name "VLAN A Side" -vlanRange "10,20,30,40,50,60"
New-HPOVNetwork -name "VLAN B Side" -VlanRange "10,20,30,40,50,60"

Create Ethernet Networks for an Active/Active configuration using the -VlanRange parameter.

 -------------------------- EXAMPLE 7 --------------------------

New-HPOVNetwork -type FC -name "Fabric A" -typicalBandwidth 2000 -maximumBandwidth 4000

Creates a new FC network type, called "Fabric A" and preferred bandwidth is 2Gb/s and max is 4Gb/s.

 -------------------------- EXAMPLE 8 --------------------------

New-HPOVNetwork -type FC -name "Fabric A" -typicalBandwidth 2000 -maximumBandwidth 4000 -fabricType FabricAttach -managedSAN Fabric_A

Creates a new FC network type, called "Fabric A", preferred bandwidth is 2Gb/s and max is 4Gb/s, and is associated with a Managed SAN Fabric.

 -------------------------- EXAMPLE 9 --------------------------

New-HPOVNetwork -importFile "c:\OneViewInput\myNewNets.json"

Creates the network(s) defined in the input file myNewNets.json

• Get-HPOVNetwork
• Get-HPOVNetworkSet
• New-HPOVNetworkSet
• Remove-HPOVNetwork
• Remove-HPOVNetworkSet
• Set-HPOVNetwork
• Set-HPOVNetworkSet

Creates one or more new Ethernet or Fibre-Channel networks on the appliance.

New-HPOVNetwork [-Name] <String> [-Type] <String> [-VlanId] <Int32> [-Subnet] <Object> [-VLANType] <String> [-Purpose] <String> [-SmartLink] <Boolean> [-PrivateNetwork] <Boolean> [-TypicalBandwidth] <Int32> [-MaximumBandwidth] <Int32>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

New-HPOVNetwork [-Name] <String> [-VlanRange] <String> [-Type] <String> [-VLANType] <String> [-Purpose] <String> [-SmartLink] <Boolean> [-PrivateNetwork] <Boolean> [-TypicalBandwidth] <Int32> [-MaximumBandwidth] <Int32>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

New-HPOVNetwork [-Name] <String> [-Type] <String> [-VlanId] <Int32> [-TypicalBandwidth] <Int32> [-MaximumBandwidth] <Int32> [-ManagedSan] <Object>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

New-HPOVNetwork [-Name] <String> [-Type] <String> [-TypicalBandwidth] <Int32> [-MaximumBandwidth] <Int32> [-LinkStabilityTime] <Int32> [-AutoLoginRedistribution] <Boolean> [-FabricType] <String> [-ManagedSan] <Object>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

New-HPOVNetwork [-ImportFile] <String>[ [-Scope] <HPOneView.Appliance.ScopeCollection>][ [-Async] <SwitchParameter>][ [-ApplianceConnection] <Object>] [<CommonParameters>]

Create a new network resource, including its default connection type. Network definitions can be supplied as direct CmdLet parameters or as input from a file containing the network definition in JSON format.

To create an Ethernet Network for Image Streamer, use the following paramters:

* Name
* VlanType = Untagged
* IPv4Subnet Object
* Purpose = Management

-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

-Async <SwitchParameter>

Use this parameter to immediately return the async task. By default, the Cmdlet will wait for the task to complete.

-AutoLoginRedistribution <Boolean>

Used for login balancing when logins are not distributed evenly over the Fibre Channel links (for example, when an uplink that was down becomes available).

True: Login redistribution is initiated automatically when the link stability time expires. False: Login redistribution must be initiated manually.

This parameter is not applicable for Direct Attach Fabric Types.

-FabricType <String>

Valid values are DirectAttach and FabricAttach. Defaults to FabricAttach

-ImportFile <String>

Full path and file name of a JSON formatted input file containing network definitions.

-LinkStabilityTime <Int32>

The time in seconds the appliance waits before reconnecting to a link that was previously offline (Login redistribution). This interval prevents connection loss due to reconnecting to a link that is unstable (going online and offline repeatedly).

-ManagedSan <Object>

Managed SAN Object or Name.

-MaximumBandwidth <Int32>

Maximum amount of bandwidth to assign, specified in Mbps. Default value is 10000.

-Name <String>

Required object to provide a display name for the network being created. If specifying the -VlanRange parameter, this will become the Nework Name Prefix (i.e. 'VLAN' will become 'VLAN-[vlanid]'.)

-PrivateNetwork <Boolean>

Default value is FALSE.

-Purpose <String>

A description of the network's role within the logical interconnect. Accepted values in string format are:

* General
* Management
* VMMigration
* FaultTolerance
* iSCSI

-Scope <HPOneView.Appliance.ScopeCollection>

Provide an HPOneView.Appliance.ScopeCollection resource object to initially associate with. Resource can also be added to scope using the Add-HPOVResourceToScope Cmdlet.

-SmartLink <Boolean>

Default value is TRUE.

-Subnet <Object>

An IPv4 Subnet Object that will be associated with a specific Ethernet Network and VLAN.

-Type <String>

Required value that specifies the type of Network Resource to create. Allowed values are:

* Ethernet
* FC
* FibreChannel
* FCoE

-TypicalBandwidth <Int32>

Preferred amount of bandwidth to assign, specified in Mbps. Default value is 2500.

-VLANType <String>

The type of VLAN configuration for the Ethernet Network. This setting is only applicable for the Uplink Set configuration, and not the Network Set it could be assigned to. Accepted values are

* Tagged
* Tunnel
* Access

Default value is Tagged.

-VlanId <Int32>

The Virtual LAN (VLAN) identification number assigned to the network. The VLAN ID must be unique. The VLAN ID cannot be changed once the network has been created.

When creating an Ethernet Network on an HPE Synergy Composer, Vlan ID 1 is not a valid ID. The allowed range is 2-4095.

-VlanRange <String>

VLAN Range of networks to create. Can be consecutive, non-consecutive or a combination of both.

e.g. -VLANRange "10-90,94,96,200-210"

<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)

HPOneView.Storage.ManagedSan [System.Management.Automation.PSCustomObject]

ManagedSan resource object to be assigned to a FC or FCoE Network

System.Collections.ArrayList

A custom status object or array of objects containing the following PsCustomObject keys:

• Name - name of the network object attempted to be created * Status - status of the creation attempt (Failed for http error return; Complete if a task object is returned)
• Description - Task object or Error object * Exception - System.Management.Automation.ErrorRecord object of the error generated

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

New-HPOVNetwork -type Ethernet -name MyNetwork1 -vlanid 100 -typicalbandwidth 5000 -maximumbandwidth 7500

Creates new Ethernet Network type, with "MyNetwork1" name, VLAN ID 100, and specifies preferred bandwidth to 5Gb/s and max to 7.5Gb/s. Network will be created on all connected appliances.

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

New-HPOVNetwork -type Ethernet -name MyNetwork1 -vlanid 100 -typicalbandwidth 5000 -maximumbandwidth 7500 -Appliance MyAppliance

Creates new Ethernet Network type, with "MyNetwork1" name, VLAN ID 100, an dspecifies preferred bandwidth to 5Gb/s and max to 7.5Gb/s to be created on 'MyAppliance'

 -------------------------- EXAMPLE 3 --------------------------

$Connection1 = Connect-HPOVMgmt MyAppliance1.domain.local Administrator MyPassword
$Connection2 = Connect-HPOVMgmt MyAppliance2.domain.local Administrator MyPassword
New-HPOVNetwork -type Ethernet -name MyNetwork1 -vlanid 100 -typicalbandwidth 5000 -maximumbandwidth 7500 -Appliance $Connection1,$Connection2

Creates new Ethernet Network type, with 'MyNetwork1' name, VLAN ID 100, an dspecifies preferred bandwidth to 5Gb/s and max to 7.5Gb/s to be created on 'MyAppliance1' and 'MyAppliance2' using the connection objects.

 -------------------------- EXAMPLE 4 --------------------------

10,20,30,40,50,60 | % { New-HPOVNetwork -type Ethernet -name "VLAN $_" -vlanid $_ }

Create multiple Ethernet Networks.

 -------------------------- EXAMPLE 5 --------------------------

10,20,30,40,50,60 | % { New-HPOVNetwork -type Ethernet -name "VLAN $_-A" -vlanid $_ }
10,20,30,40,50,60 | % { New-HPOVNetwork -type Ethernet -name "VLAN $_-B" -vlanid $_ }

Create Ethernet Networks for an Active/Active configuration.

 -------------------------- EXAMPLE 6 --------------------------

New-HPOVNetwork -name "VLAN A Side" -vlanRange "10,20,30,40,50,60"
New-HPOVNetwork -name "VLAN B Side" -VlanRange "10,20,30,40,50,60"

Create Ethernet Networks for an Active/Active configuration using the -VlanRange parameter.

 -------------------------- EXAMPLE 7 --------------------------

New-HPOVNetwork -type FC -name "Fabric A" -typicalBandwidth 2000 -maximumBandwidth 4000

Creates a new FC network type, called 'Fabric A' and preferred bandwidth is 2Gb/s and max is 4Gb/s.

 -------------------------- EXAMPLE 8 --------------------------

New-HPOVNetwork -type FC -name "Fabric A" -typicalBandwidth 2000 -maximumBandwidth 4000 -fabricType FabricAttach -managedSAN Fabric_A

Creates a new FC network type, called 'Fabric A', preferred bandwidth is 2Gb/s and max is 4Gb/s, and is associated with a Managed SAN Fabric.

 -------------------------- EXAMPLE 9 --------------------------

New-HPOVNetwork -importFile "c:\OneViewInput\myNewNets.json"

Creates the network(s) defined in the input file myNewNets.json

• Get-HPOVNetwork
• Get-HPOVNetworkSet
• New-HPOVNetworkSet
• Remove-HPOVNetwork
• Remove-HPOVNetworkSet
• Set-HPOVNetwork
• Set-HPOVNetworkSet