New-LabNetworkAdapterDefinition
SYNOPSIS
Creates a network adapter definition roughly interpreted as a NIC
SYNTAX
manual (Default)
New-LabNetworkAdapterDefinition -VirtualSwitch <String> [-InterfaceName <String>] [-Ipv4Address <IPNetwork[]>]
[-Ipv4Gateway <IPAddress>] [-Ipv4DNSServers <IPAddress[]>] [-IPv6Address <IPNetwork[]>]
[-IPv6AddressPrefix <Int32>] [-IPv6Gateway <String>] [-IPv6DNSServers <String[]>]
[-ConnectionSpecificDNSSuffix <String>] [-AppendParentSuffixes <Boolean>] [-AppendDNSSuffixes <String[]>]
[-RegisterInDNS <Boolean>] [-DnsSuffixInDnsRegistration <Boolean>] [-NetBIOSOptions <String>]
[-AccessVLANID <Int32>] [-ManagementAdapter <Boolean>] [-MacAddress <String>] [-Default <Boolean>]
[<CommonParameters>]
dhcp
New-LabNetworkAdapterDefinition -VirtualSwitch <String> [-InterfaceName <String>] [-UseDhcp]
[-Ipv4DNSServers <IPAddress[]>] [-IPv6DNSServers <String[]>] [-ConnectionSpecificDNSSuffix <String>]
[-AppendParentSuffixes <Boolean>] [-AppendDNSSuffixes <String[]>] [-RegisterInDNS <Boolean>]
[-DnsSuffixInDnsRegistration <Boolean>] [-NetBIOSOptions <String>] [-AccessVLANID <Int32>]
[-ManagementAdapter <Boolean>] [-MacAddress <String>] [-Default <Boolean>] [<CommonParameters>]
DESCRIPTION
Creates a network adapter definition roughly interpreted as a NIC. This NIC can then be connected to a lab machine when defining the machine using Add-LabMachineDefinition
EXAMPLES
Example 1
$netAdapter = @()
$netAdapter += New-LabNetworkAdapterDefinition -VirtualSwitch $labName -Ipv4Address 192.168.30.50
$netAdapter += New-LabNetworkAdapterDefinition -VirtualSwitch 'Default Switch' -UseDhcp
Add-LabMachineDefinition -Name POSHFS1 -Memory 512MB -Roles FileServer, Routing -NetworkAdapter $netAdapter
In order to create a machine capable of routing, you can assign two network adapter definitions to it
PARAMETERS
-AccessVLANID
The VLAN ID to configure
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AppendDNSSuffixes
List of DNS suffixes to append
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AppendParentSuffixes
Indicates that parent suffixes should be appended to the DNS suffix
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ConnectionSpecificDNSSuffix
The DNS suffix (Windows)
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Default
Indicates that this adapter will be the default adapter
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DnsSuffixInDnsRegistration
Indicates that the DNS suffix should be included in the DNS registration
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InterfaceName
The name of the interface on the VM
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Ipv4Address
The IP address of the adapter
Type: IPNetwork[]
Parameter Sets: manual
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Ipv4DNSServers
The DNS servers to use
Type: IPAddress[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Ipv4Gateway
The gateway that should be used
Type: IPAddress
Parameter Sets: manual
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IPv6Address
The IPv6 address of this adapter
Type: IPNetwork[]
Parameter Sets: manual
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IPv6AddressPrefix
The IPv6 prefix
Type: Int32
Parameter Sets: manual
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IPv6DNSServers
The IPv6 DNS server list
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-IPv6Gateway
The IPv6 gateway to configure
Type: String
Parameter Sets: manual
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-MacAddress
The hardware address of the virtual adapter
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ManagementAdapter
Indicates that this adapter is used as a management adapter
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-NetBIOSOptions
The NetBIOS options to set (Default, Enabled, Disabled)
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RegisterInDNS
Indicates that the name should be registered in DNS
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseDhcp
Indicates that DHCP should be used. Useful e.g. for the Default Switch
Type: SwitchParameter
Parameter Sets: dhcp
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-VirtualSwitch
The name of the virtual switch.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.