New-SCSubnetVLan
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 25This 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.