Delen via

Get-SCVirtualCOMPort

  • Referentie
Module:
VirtualMachineManager

Hiermee haalt u een virtuele COM-poort op van een virtuele machine, een sjabloon voor virtuele machines of een hardwareprofiel.

Syntaxis

Get-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   [-All]
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -HardwareProfile <HardwareProfile>
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -VM <VM>
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -VMTemplate <Template>
   [<CommonParameters>]

Description

De Get-SCVirtualCOMPort-cmdlet haalt com-poortobjecten (Virtual Communication) op. Met deze cmdlet worden een of beide COM-poorten opgehaald van een virtuele-machineobject, een sjabloonobject voor virtuele machines of een hardwareprofielobject dat door Virtual Machine Manager (VMM) wordt beheerd.

Een virtuele COM-poort kan verbinding maken met een fysieke poort op een hostserver van een virtuele machine, met een tekstbestand of met een benoemde pijp. Elke virtuele machine, virtuele-machinesjabloon en hardwareprofiel bevat precies twee COM-poorten.

Voorbeelden

Voorbeeld 1: COM-poorten ophalen voor een virtuele machine

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualCOMPort -VM $VM

Met de eerste opdracht wordt de virtuele machine met de naam VM01 opgehaald en wordt dat object vervolgens opgeslagen in de $VM variabele.

Met de tweede opdracht worden de virtuele COM-poortobjecten op VM01 opgehaald en wordt informatie over deze poorten weergegeven.

Voorbeeld 2: COM-poorten ophalen voor een sjabloon

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualCOMPort -VMTemplate $VMTemplate

Met de eerste opdracht wordt de virtuele-machinesjabloon met de naam VMTemplate01 opgehaald en wordt dat object vervolgens opgeslagen in de variabele $VMTemplate.

Met de tweede opdracht worden de virtuele COM-poortobjecten voor VMTemplate01 opgehaald en wordt informatie over deze poorten weergegeven.

Voorbeeld 3: COM-poorten ophalen voor een hardwareprofiel

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualCOMPort -HardwareProfile $HWProfile

Met de eerste opdracht wordt het hardwareprofiel met de naam NewHWProfile01 opgehaald en wordt dat object vervolgens opgeslagen in de variabele $HWProfile.

Met de tweede opdracht worden de virtuele COM-poortobjecten voor NewHWProfile01 opgehaald en wordt informatie over deze poorten weergegeven.

Parameters

-All

Geeft aan dat deze cmdlet een volledige lijst met onderliggende COM-poorten krijgt, onafhankelijk van het bovenliggende object.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-HardwareProfile

Hiermee geeft u een hardwareprofielobject.

Type:HardwareProfile
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VM

Hiermee geeft u een virtuele machine waarvoor deze cmdlet virtuele COM-poorten ophaalt. Als u een virtuele-machineobject wilt verkrijgen, gebruikt u de cmdlet Get-SCVirtualMachine.

Type:VM
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMTemplate

Hiermee geeft u een VMM-sjabloon op die wordt gebruikt voor het maken van virtuele machines waarvoor deze cmdlet virtuele COM-poorten ophaalt. Als u een VMM-sjabloonobject wilt verkrijgen, gebruikt u de cmdlet Get-SCVMTemplate.

Type:Template
Aliassen:Template
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

VirtualCOMPort

Met deze cmdlet wordt een VirtualCOMPort--object geretourneerd.