Get-VMSwitch

Get-VMSwitch

Gets virtual switches from one or more virtual Hyper-V hosts.

Syntax

Parameter Set: Name
Get-VMSwitch [[-Name] <String> ] [[-ResourcePoolName] <String[]> ] [-ComputerName <String[]> ] [-SwitchType <VMSwitchType[]> ] [ <CommonParameters>]

Parameter Set: Id
Get-VMSwitch [[-Id] <Guid[]> ] [[-ResourcePoolName] <String[]> ] [-ComputerName <String[]> ] [-SwitchType <VMSwitchType[]> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Get-VMSwitch gets the virtual switches from a Hyper-V host. If you specify no parameters, this cmdlet returns all virtual switches from the local Hyper-V host.

Parameter

-ComputerName<String[]>

Specifies one or more Hyper-V hosts from which virtual switches are to be retrieved. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer — use “localhost” or a dot (“.”) to specify the local computer explicitly.

Aliasse	Keiner
Erforderlich?	false
Position?	named
Standardwert	.
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-Id<Guid[]>

Specifies the unique identifier of the virtual switch to be retrieved.

Aliasse	SwitchId
Erforderlich?	false
Position?	1
Standardwert	Keiner
Pipelineeingaben akzeptieren?	True (ByValue, ByPropertyName)
Platzhalterzeichen akzeptieren?	false

-Name<String>

Specifies the name of the virtual switch to be retrieved.

Aliasse	SwitchName
Erforderlich?	false
Position?	1
Standardwert	Keiner
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-ResourcePoolName<String[]>

Specifies the resource pool from which the virtual switches are to be retrieved.

Aliasse	Keiner
Erforderlich?	false
Position?	2
Standardwert	Keiner
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

-SwitchType<VMSwitchType[]>

Specifies the type of the virtual switches to be retrieved. Allowed values are External, Internal, and Private.

Aliasse	Keiner
Erforderlich?	false
Position?	named
Standardwert	Keiner
Pipelineeingaben akzeptieren?	false
Platzhalterzeichen akzeptieren?	false

<CommonParameters>

Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Eingaben

Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.

Ausgaben

Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.

• Microsoft.HyperV.PowerShell.EthernetSwitch

Beispiele

Example 1

Gets all virtual switches from the local Hyper-V host.

PS C:\> Get-VMSwitch

Example 2

Gets all virtual switches that connect to the external network.

PS C:\> Get-VMSwitch –SwitchType External