Add-Ipam Subnet

Syntax

Add-IpamSubnet
   [-Name] <String>
   [-NetworkId] <String>
   [-NetworkType <VirtualizationType>]
   [-AddressSpace <String>]
   [-Owner <String>]
   [-Description <String>]
   [-VlanId <UInt16[]>]
   [-VmmLogicalNetwork <String>]
   [-NetworkSite <String>]
   [-VirtualSubnetId <UInt32>]
   [-CustomConfiguration <String>]
   [-PassThru]
   [-CimSession <CimSession[]>]
   [-ThrottleLimit <Int32>]
   [-AsJob]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Add-IpamSubnet cmdlet adds an IP subnet to an IP Address Management (IPAM) server. Use the cmdlet to add a NonVirtualized, Provider or Customer IP subnet in IPAM. If the network type of the subnet to add is Provider or NonVirtualized, the cmdlet will add it to the default address space, unless you specify an address space. If the network type of the range to add is Customer, you must specify an address space.

You can associate virtualized subnets, either provider or customer, with a logical network and a network site. These properties represent an abstraction of a physical network and are inherited by all ranges and addresses that map to this subnet.

Examples

Example 1: Add a subnet

PS C:\> Add-IpamSubnet -Name "Contoso_2" -NetworkId "10.12.0.0/16" -VlanId 13,10 -PassThru
Name                 : Contoso_2

NetworkId            : 10.12.0.0/16

NetworkType          : NonVirtualized

Overlapping          : False

NetworkSite          :

VmmLogicalNetwork    :

ProviderAddressSpace : Default

CustomerAddressSpace :

VlanId               : {13, 10}

Owner                :

This command adds an IPv4 subnet named Contoso_2 to the network ID 10.12.0.0/16 and associates it with VLAN 13,10.

The command includes the PassThru parameter, so it displays results to the console.

Example 2: Add a subnet to the default address space

PS C:\> Add-IpamSubnet -Name "Contoso_3" -NetworkId "10.13.0.0/16" -NetworkType Provider -VmmLogicalNetwork Storage -NetworkSite "Site03" -VlanId 13,10 -PassThru

Name                 : Contoso_3

NetworkId            : 10.13.0.0/16

NetworkType          : Provider

Overlapping          : False

NetworkSite          : Site03

VmmLogicalNetwork    : Storage

ProviderAddressSpace : Default

CustomerAddressSpace :

VlanId               : {13, 10}

Owner                :

This command adds an IPV4 subnet named Contoso_3 with network type provider to the default address space. The command also adds the IPV4 subnet to the network ID 10.13.0.0/16 and sets the NetworkSite name to Site03.

The command includes the PassThru parameter, so it displays results to the console.

Example 3: Add a subnet for a customer network type

PS C:\> Add-IpamSubnet -Name "Contoso_4" -NetworkId "10.13.0.0/16" -NetworkType Customer -AddressSpace "NetCat" -VmmLogicalNetwork Storage -NetworkSite "Site03 -VirtualSubnetId 10 -PassThru
Name                 : Contoso_4

NetworkId            : 10.13.0.0/16

NetworkType          : Customer

Overlapping          : False

NetworkSite          : Site03

VmmLogicalNetwork    : Storage

ProviderAddressSpace : ContosoDatacenter

CustomerAddressSpace : NetCat

VlanId               : {13, 10}

Owner                :

This command adds an IPv4 subnet named Contoso_4 with the network and prefix of 10.13.0.0/16 and has the network type customer. The command also sets the address space as NetCat and the network site as Site03.

The command includes the PassThru parameter, so it displays results to the console.

Example 4: Add a subnet and attach metadata

PS C:\> Add-IpamSubnet -Name "Contosov6_10" -NetworkId 2001:db8::ff00/120 -CustomConfiguration "Country=United States;ADSite=Site01" | Format-List Name, NetworkId, Overlapping, CustomConfiguration
Name                : Contosov6_10

NetworkId           : 2001:db8::ff00/120

Overlapping         : False

CustomConfiguration : Country=United States;ADSite=Site01;

This command adds physical subnets named Contosov6_10 and attaches AD Site metadata to the subnets.

The command includes the PassThru parameter, so it displays results to the console.

Required Parameters

Optional Parameters

Outputs

CimInstance#ROOT/microsoft/ipam/MSFT_IPAM_Subnet

This cmdlet returns an object that represents an IP Subnet in IPAM Server.

Related Links

• Export-IpamSubnet
• Get-IpamSubnet
• Import-IpamSubnet
• Remove-IpamSubnet
• Set-IpamSubnet