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