Share via

New-SCSubnetVLan

  • Reference
Module:
VirtualMachineManager

Creates a subnet VLAN object.

Syntax

New-SCSubnetVLan
   [-VMMServer <ServerConnection>]
   [-VLanID <Int32>]
   [-Subnet <String>]
   [-SupportsDHCP <Boolean>]
   [-SecondaryVLanID <Int32>]
   [<CommonParameters>]

Description

The New-SCSubnetVLan cmdlet creates a subnet VLAN object. You can use a subnet VLAN to create a logical network definition or VM subnet.

For information about how to create a logical network definition, type Get-Help New-SCLogicalNetworkDefinition -Detailed.

For information about how to create a VM subnet, type Get-Help New-SCVMSubnet -Detailed.

Examples

Example 1: Create a subnet VLAN

PS C:\> $SubnetVLAN = New-SCSubnetVLAN -Subnet "10.0.0.1/24" -VLanID 25

This command creates a subnet VLAN object with a subnet value of 10.0.0.1/24 and a VLAN value of 25.

Parameters

-SecondaryVLanID

Specifies the secondary VLAN ID for a subnet VLAN.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Subnet

Specifies an IP subnet (IPv4 or IPv6) in Classless Inter-Domain Routing (CIDR) notation.

  • Example format for an IPv4 subnet: 192.168.0.1/24
  • Example format for an IPv6 subnet: FD4A:29CD:184F:3A2C::/64

Note: An IP subnet cannot overlap with any other subnet in a host group or child host groups.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SupportsDHCP

Indicates whether DHCP is supported by the subnet VLAN.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanID

Assigns a numerical identifier in the range 1-4094 to a virtual network adapter on a virtual machine or to a physical network adapter on a virtual machine host.

Configure a VLanID on a Hyper-V, VMware ESX, or Citrix XenServer host on an externally bound physical network adapter when the VLan mode is Access.

Configure a VLanID on a virtual network adapter of a virtual machine bound to a physical network adapter on the host, or bound to an internal virtual network on the host.

Example format: -VLanEnabled -VLanMode "Access" -VLANID 35

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Specifies a Virtual Machine Manager (VMM) server object.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Outputs

SubnetVLAN

This cmdlet returns a SubnetVLAN object.