New-NsxLogicalSwitch

NAME New-NsxLogicalSwitch



SYNOPSIS

Creates a new Logical Switch





SYNTAX

New-NsxLogicalSwitch -TransportZone <XmlElement> [-Name] <String> [-Description <String>] [-TenantId <String>]

[-ControlPlaneMode <String>] [-Connection <PSObject>] [<CommonParameters>]





DESCRIPTION

An NSX Logical Switch provides L2 connectivity to VMs attached to it.

A Logical Switch is 'bound' to a Transport Zone, and only hosts that are

members of the Transport Zone are able to host VMs connected to a Logical

Switch that is bound to it. All Logical Switch operations require a

Transport Zone. A new Logical Switch defaults to the control plane mode of

the Transport Zone it is created in, but CP mode can specified as required.





PARAMETERS

-TransportZone <XmlElement>



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-Name <String>



Required? true

Position? 2

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Description <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-TenantId <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ControlPlaneMode <String>



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-Connection <PSObject>

PowerNSX Connection object



Required? false

Position? named

Default value $defaultNSXConnection

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS



OUTPUTS



-------------------------- EXAMPLE 1 --------------------------



PS C:\\>Get-NsxTransportZone | New-NsxLogicalSwitch -name LS6



Create a Logical Switch with default control plane mode on all Transport Zones.









-------------------------- EXAMPLE 2 --------------------------



PS C:\\>Get-NsxTransportZone -LocalOnly | New-NsxLogicalSwitch -name LS6



Create a Logical Switch with default control plane mode on All Local Transport Zones.

(Use -UniversalOnly for create on Universal Transport Zones)









-------------------------- EXAMPLE 3 --------------------------



PS C:\\>Get-NsxTransportZone | New-NsxLogicalSwitch -name LS6 -ControlPlaneMode MULTICAST_MODE



Create a Logical Switch with a specific control plane mode on all Transport Zones.











RELATED LINKS