This project is read-only.

NAME

New-HPOVAddressRange

SYNOPSIS

Create an Address Range.

SYNTAX

New-HPOVAddressRange [-PoolType] <String> [-RangeType] <String> [<CommonParameters>]

New-HPOVAddressRange [-PoolType] <String> [-RangeType] <String> [-Start] <String> [-End] <String> [<CommonParameters>]

DESCRIPTION

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), and Server Serial Number (VSN).

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

PARAMETERS

-PoolType <String>

Specify the Pool Type the new Range will be assinged to.  Accepted values are:

    • VMAC
    • VWWN
    • VSN

Aliases None
Required? True
Position? 1
Default value <none>       
Accept pipeline input? false
Accept wildcard characters?     false

-RangeType <Sring>

The type of Address Range to create.  Accepted values are:

    • Generated
    • Custom

Aliases None
Required? True
Position? 2
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.
Aliases None
Required? True
Position? 3                  
Default value <none>
Accept pipeline input? false
Accept wildcard characters?     false
-End <String>
The ending address in the range.  Cannot overlap with other address ranges.
Aliases None
Required? True
Position? 4                  
Default value <none>
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).

INPUTS

None.  You cannot pipe objects to this cmdlet.

OUTPUTS

System.Management.Automation.PSCustomObject
Newly created and assigned Address Pool Range resource object.

RELATED LINKS


EXAMPLES


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

PS C:\> New-HPOVAddressRange -PoolType vmac -RangeType Generated
Create a new Appliance generated VMAC Pool Range.
-------------------------- EXAMPLE 2 --------------------------

PS C:\> New-HPOVAddressRange vwwn Custom 10:00:6C:9F:06:B0:00:00 10:00:6C:9F:06:BF:FF:FF
Create a new VWWN Address Pool Range with the custom addresses.
-------------------------- EXAMPLE 3 --------------------------

PS C:\> New-HPOVAddressRange vmac Custom 12:22:33:44:55:00 12:22:33:44:66:FF


type                 : Range
name                 : VMAC
prefix               :
enabled              : True
startAddress         : 12:22:33:44:55:00
endAddress           : 12:22:33:44:66:FF
freeIdCount          : 4608
rangeCategory        : CUSTOM
totalCount           : 4608
allocatedIdCount     : 0
defaultRange         : False
allocatorUri         : /rest/id-pools/vmac/ranges/814bbeba-5f36-4a5b-a606-d65189eb8a1a/allocator
collectorUri         : /rest/id-pools/vmac/ranges/814bbeba-5f36-4a5b-a606-d65189eb8a1a/collector
reservedIdCount      : 0
freeFragmentUri      : /rest/id-pools/vmac/ranges/814bbeba-5f36-4a5b-a606-d65189eb8a1a/free-fragments?start=0&count=-1
allocatedFragmentUri : /rest/id-pools/vmac/ranges/814bbeba-5f36-4a5b-a606-d65189eb8a1a/allocated-fragments?start=0&count=-1
uri                  : /rest/id-pools/vmac/ranges/814bbeba-5f36-4a5b-a606-d65189eb8a1a
category             : id-range-VMAC
eTag                 : fc0f67d3-642f-4545-806a-f2e8c9441536
created              : 2014-03-07 20:04:34.319
modified             : 2014-03-07 20:04:34.319
Create a new VMAC Address Pool Range with the custom addresses, and the returned new Address Range resource object created.

Last edited Mar 7, 2014 at 8:31 PM by ChrisLynchHP, version 4