Get-VMComPort

Get-VMComPort

Gets the COM ports of a virtual machine or snapshot.

Syntax

Parameter Set: VMName
Get-VMComPort [-VMName] <String[]> [[-Number] <Int32> ] [-ComputerName <String[]> ] [ <CommonParameters>]

Parameter Set: VMObject
Get-VMComPort [-VM] <VirtualMachine[]> [[-Number] <Int32> ] [ <CommonParameters>]

Parameter Set: VMSnapshot
Get-VMComPort [-VMSnapshot] <VMSnapshot> [[-Number] <Int32> ] [ <CommonParameters>]

Detaillierte Beschreibung

The Get-VMComPort cmdlet gets the COM ports of a virtual machine or snapshot.

Parameter

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which the COM ports of a virtual machine or snapshot 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

-Number<Int32>

Specifies the Id (1 or 2) of the COM ports to be retrieved.

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

-VM<VirtualMachine[]>

Specifies the virtual machine whose COM ports are to be retrieved.

Aliasse	Keiner
Erforderlich?	true
Position?	1
Standardwert	Keiner
Pipelineeingaben akzeptieren?	true (ByValue)
Platzhalterzeichen akzeptieren?	false

-VMName<String[]>

Specifies the name of the virtual machine whose COM ports are to be retrieved.

Aliasse	Keiner
Erforderlich?	true
Position?	1
Standardwert	Keiner
Pipelineeingaben akzeptieren?	true (ByValue)
Platzhalterzeichen akzeptieren?	true

-VMSnapshot<VMSnapshot>

Specifies the snapshot whose COM ports are to be retrieved.

Aliasse	Keiner
Erforderlich?	true
Position?	1
Standardwert	Keiner
Pipelineeingaben akzeptieren?	true (ByValue)
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.ComPort

Beispiele

Example 1

Gets all COM ports associated with virtual machine TestVM.

PS C:\> Get-VMComPort TestVM

Example 2

Gets the second COM port associated with virtual machine TestVM.

PS C:\> Get-VMComPort TestVM –Number 2