New HPOVAddressPoolRange - HewlettPackard/POSH-HPEOneView GitHub Wiki
Create an Address Range.
New-HPOVAddressPoolRange [-PoolType] <String> [-RangeType] <String> [-ApplianceConnection] <Object> [<CommonParameters>]New-HPOVAddressPoolRange [-IPv4Subnet] <Object> [-Name] <String> [-Start] <String> [-End] <String> [-ApplianceConnection] <Object> [<CommonParameters>]New-HPOVAddressPoolRange [-PoolType] <String> [-RangeType] <String> [-Start] <String> [-End] <String> [-ApplianceConnection] <Object> [<CommonParameters>]This cmdlet will assist with creating a new Address Pool Range. The support Address Pool Types are MAC Addresses (VMAC), Fibre Channel/FCoE World Wide Name (VWWN), Server Serial Number (VSN), and IPv4 Address Pools (IPv4).
When creating new Address Pool Ranges, the Generated Range Type will allocate 1,048,576 MAC or WWN addresses, whereas it will allocate 46,656 Serial Numbers.
If you specify a Custom Range Type, you must specify a range of addresses no smaller than 128, and no more than 1,048,576 per range.
Custom Address Ranges must adhere to the following format rules:
* The MAC Address must be IEEE Compliant, and the format must be XH:XX:XX:XX:XX:XX, where H must be 0, 2, 4, 6, 8, A, C or E.
Example: 12:22:33:44:55:00
* The WWN Address must be IEEE compliant, and the format must be 10:00:XH:XX:XX:XX:XX:XX, where H must be 0, 2, 4, 6, 8, A, C or E.
Example: 10:00:6C:9F:06:B0:00:00
* The Serial Number addresses must start with VCU, and cannot contain more than 10 characters total.
Example: VCU1234567
IPv4 Address Subnets do not support Auto Generated, as the RangeType parameter is not required. When creating a new IPv4 Address Subnet, you must provide a unique Name, Subnet Mask (CIDR [e.g. 24] or IPv4 Address Value [e.g. 255.255.255.0]), Start and End IPv4 Address, Gateway and Domain Name. DNS Servers are optional. To add more Address Ranges to a Subnet after creating it, please use the Add-HPOVAddressRange CMDLET.
-ApplianceConnection <Object>
Aliases [-Appliance]
Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s).
When attempting to create a new IPv4 Address Pool/Subnet, only a single HPOneView.Appliance.Connection object or Name property value is allowed. 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 |
-End <String>
The ending address in the range. Cannot overlap with other address ranges, and should be unique within the datacenter/infrastructure.
| Aliases | None |
| Required? | true |
| Position? | named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-IPv4Subnet <Object>
The IPv4 Subnet that the new IPv4 Range will be assigned to. Start and End values must be within the Network ID and Subnet value of the IPv4 Address Subnet Pool.
| Aliases | Subnet |
| Required? | true |
| Position? | named |
| Default value | |
| Accept pipeline input? | true (ByValue) |
| Accept wildcard characters? | False |
-Name <String>
Provide the IPv4Address Pool Range Name.
| Aliases | None |
| Required? | true |
| Position? | named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-PoolType <String>
Specify the Pool Type the new Range will be assinged to. Accepted values are:
* VMAC
* VWWN
* VSN
| Aliases | None |
| Required? | true |
| Position? | named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-RangeType <String>
The type of Address Range to create (not applicable for IPv4 Address Pools/Subnets). Accepted values are:
* Generated
* Custom
| Aliases | None |
| Required? | true |
| Position? | named |
| Default value | Generated |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Start <String>
The starting address in the range. Cannot overlap with other address ranges, and should be unique within the datacenter/infrastructure.
| Aliases | None |
| Required? | true |
| 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)
HPOneView.Appliance.IPv4AddressSubnet [System.Management.Automation.PSCustomObject]
IPv4 Address Subnet resource object from Get-HPOVAddressPoolSubnet
HPOneView.Appliance.AddressPoolRange [System.Management.Automation.PSCustomObject]
Newly created and assigned Address Pool Range resource object
-------------------------- EXAMPLE 1 --------------------------PS C:> New-HPOVAddressPoolRange -PoolType vmac -RangeType Generated
Create a new Appliance generated VMAC Pool Range.
-------------------------- EXAMPLE 2 --------------------------PS C:> New-HPOVAddressPoolRange -PoolType vwwn -RangeType Custom -Start 10:00:6C:9F:06:B0:00:00 -End 10:00:6C:9F:06:BF:FF:FF
Create a new VWWN Address Pool Range with the custom addresses, for the MyAppliance1.domain.com appliance connection.
-------------------------- EXAMPLE 3 --------------------------PS C:> Get-HPOVAddressPoolSubnet -NetworkId 192.168.20.0 | New-HPOVAddressPoolRange -Name "VLAN20 Mgmt" -Start 192.168.20.100 -end 192.168.20.200
Create a new IPv4 Address Pool Range, for the MyAppliance1.domain.com appliance connection.
Create an Address Range.
New-HPOVAddressPoolRange [-PoolType] <String> [-RangeType] <String> [-ApplianceConnection] <Object> [<CommonParameters>]New-HPOVAddressPoolRange [-IPv4Subnet] <Object> [-Name] <String> [-Start] <String> [-End] <String> [-ApplianceConnection] <Object> [<CommonParameters>]New-HPOVAddressPoolRange [-PoolType] <String> [-RangeType] <String> [-Start] <String> [-End] <String> [-ApplianceConnection] <Object> [<CommonParameters>]This cmdlet will assist with creating a new Address Pool Range. The support Address Pool Types are MAC Addresses (VMAC), Fibre Channel/FCoE World Wide Name (VWWN), Server Serial Number (VSN), and IPv4 Address Pools (IPv4).
When creating new Address Pool Ranges, the Generated Range Type will allocate 1,048,576 MAC or WWN addresses, whereas it will allocate 46,656 Serial Numbers.
If you specify a Custom Range Type, you must specify a range of addresses no smaller than 128, and no more than 1,048,576 per range.
Custom Address Ranges must adhere to the following format rules:
* The MAC Address must be IEEE Compliant, and the format must be XH:XX:XX:XX:XX:XX, where H must be 0, 2, 4, 6, 8, A, C or E.
Example: 12:22:33:44:55:00
* The WWN Address must be IEEE compliant, and the format must be 10:00:XH:XX:XX:XX:XX:XX, where H must be 0, 2, 4, 6, 8, A, C or E.
Example: 10:00:6C:9F:06:B0:00:00
* The Serial Number addresses must start with VCU, and cannot contain more than 10 characters total.
Example: VCU1234567
IPv4 Address Subnets do not support Auto Generated, as the RangeType parameter is not required. When creating a new IPv4 Address Subnet, you must provide a unique Name, Subnet Mask (CIDR [e.g. 24] or IPv4 Address Value [e.g. 255.255.255.0]), Start and End IPv4 Address, Gateway and Domain Name. DNS Servers are optional. To add more Address Ranges to a Subnet after creating it, please use the Add-HPOVAddressRange CMDLET.
-ApplianceConnection <Object>
Aliases [-Appliance]
Specify one or more HPOneView.Appliance.Connection object(s) or Name property value(s).
When attempting to create a new IPv4 Address Pool/Subnet, only a single HPOneView.Appliance.Connection object or Name property value is allowed. 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 |
-End <String>
The ending address in the range. Cannot overlap with other address ranges, and should be unique within the datacenter/infrastructure.
| Aliases | None |
| Required? | true |
| Position? | named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-IPv4Subnet <Object>
The IPv4 Subnet that the new IPv4 Range will be assigned to. Start and End values must be within the Network ID and Subnet value of the IPv4 Address Subnet Pool.
| Aliases | Subnet |
| Required? | true |
| Position? | named |
| Default value | |
| Accept pipeline input? | true (ByValue) |
| Accept wildcard characters? | False |
-Name <String>
Provide the IPv4Address Pool Range Name.
| Aliases | None |
| Required? | true |
| Position? | named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-PoolType <String>
Specify the Pool Type the new Range will be assinged to. Accepted values are:
* VMAC
* VWWN
* VSN
| Aliases | None |
| Required? | true |
| Position? | named |
| Default value | |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-RangeType <String>
The type of Address Range to create (not applicable for IPv4 Address Pools/Subnets). Accepted values are:
* Generated
* Custom
| Aliases | None |
| Required? | true |
| Position? | named |
| Default value | Generated |
| Accept pipeline input? | false |
| Accept wildcard characters? | False |
-Start <String>
The starting address in the range. Cannot overlap with other address ranges, and should be unique within the datacenter/infrastructure.
| Aliases | None |
| Required? | true |
| 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)
HPOneView.Appliance.IPv4AddressSubnet [System.Management.Automation.PSCustomObject]
IPv4 Address Subnet resource object from Get-HPOVAddressPoolSubnet
HPOneView.Appliance.AddressPoolRange [System.Management.Automation.PSCustomObject]
Newly created and assigned Address Pool Range resource object
-------------------------- EXAMPLE 1 --------------------------PS C:> New-HPOVAddressPoolRange -PoolType vmac -RangeType Generated
Create a new Appliance generated VMAC Pool Range.
-------------------------- EXAMPLE 2 --------------------------PS C:> New-HPOVAddressPoolRange -PoolType vwwn -RangeType Custom -Start 10:00:6C:9F:06:B0:00:00 -End 10:00:6C:9F:06:BF:FF:FF
Create a new VWWN Address Pool Range with the custom addresses, for the MyAppliance1.domain.com appliance connection.
-------------------------- EXAMPLE 3 --------------------------PS C:> Get-HPOVAddressPoolSubnet -NetworkId 192.168.20.0 | New-HPOVAddressPoolRange -Name 'VLAN20 Mgmt' -Start 192.168.20.100 -end 192.168.20.200
Create a new IPv4 Address Pool Range, for the MyAppliance1.domain.com appliance connection.