< Back

Disconnect-NsxLogicalSwitch

Sat Jan 18, 2020 9:00 pm

NAME Disconnect-NsxLogicalSwitch



SYNOPSIS

Disconnects a VM from a logical switch





SYNTAX

Disconnect-NsxLogicalSwitch -VirtualMachine <VirtualMachineInterop[]> [-DisconnectMultipleNics] [-Confirm]

[-FailOnTimeout] [-WaitTimeout <Int32>] [-Connection <PSObject>] [<CommonParameters>]



Disconnect-NsxLogicalSwitch -NetworkAdapter <NetworkAdapterInterop[]> [-DisconnectMultipleNics] [-Confirm]

[-FailOnTimeout] [-WaitTimeout <Int32>] [-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.



Disconnect-NsxLogicalSwitch accepts either a VM or NIC and detaches it from

the specified LogicalSwitch.





PARAMETERS

-VirtualMachine <VirtualMachineInterop[]>

VM or collection of VMs to attach to specified logical switch.



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-NetworkAdapter <NetworkAdapterInterop[]>

Network Adapter or collection of Network Adapters to attach to specified logical switch.



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-DisconnectMultipleNics [<SwitchParameter>]

If specified VM is multi homed, disconnect all NICs from the same network. Defaults to $false



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-Confirm [<SwitchParameter>]

Prompt for confirmation.



Required? false

Position? named

Default value True

Accept pipeline input? false

Accept wildcard characters? false



-FailOnTimeout [<SwitchParameter>]

If job reaches -WaitTimeout without failing or completing, do we prompt, or fail with error?



Required? false

Position? named

Default value False

Accept pipeline input? false

Accept wildcard characters? false



-WaitTimeout <Int32>

Seconds to wait for connection job to complete. Defaults to 30 seconds.



Required? false

Position? named

Default value 30

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





RELATED LINKS