Share via


New-SCSubnetVLan

New-SCSubnetVLan

Creates a subnet VLAN object.

Syntax

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

Detailed Description

The New-SCSubnetVLan cmdlet creates a subnet VLAN object. You can use a subnet VLAN to create a logical network definition or virtual machine 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.

Parameters

-SecondaryVLanID<Int32]>

Specifies the secondary VLAN ID for a subnet VLAN.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Subnet<String>

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-SupportsDHCP<Boolean>

Indicates whether DHCP is supported by the subnet VLAN.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VLanID<Int32]>

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 $True -VLanMode "Access" -VLanID 35

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • SubnetVLAN

Examples

Example 1: Create a subnet VLAN

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

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

New-SCLogicalNetworkDefinition

New-SCVMSubnet