Freigeben über

Get-SCVirtualCOMPort

  • Referenz
Modul:
VirtualMachineManager

Ruft einen virtuellen COM-Port von einem virtuellen Computer, einer Vorlage für virtuelle Computer oder einem Hardwareprofil ab.

Syntax

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

Beschreibung

Das cmdlet Get-SCVirtualCOMPort ruft COM-Portobjekte (Virtual Communication) ab. Dieses Cmdlet ruft einen oder beide COM-Ports aus einem Objekt eines virtuellen Computers, einem Vorlagenobjekt eines virtuellen Computers oder einem Hardwareprofilobjekt ab, das virtual Machine Manager (VMM) verwaltet.

Ein virtueller COM-Port kann eine Verbindung mit einem physischen Port auf einem Hostserver eines virtuellen Computers, mit einer Textdatei oder mit einer benannten Pipe herstellen. Jeder virtuelle Computer, jede Virtuelle Computervorlage und jedes Hardwareprofil enthält genau zwei COM-Ports.

Beispiele

Beispiel 1: Abrufen von COM-Ports für einen virtuellen Computer

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

Der erste Befehl ruft den virtuellen Computer vm01 ab und speichert dieses Objekt dann in der $VM Variablen.

Der zweite Befehl ruft die virtuellen COM-Portobjekte auf VM01 ab und zeigt Informationen zu diesen Ports an.

Beispiel 2: Abrufen von COM-Ports für eine Vorlage

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

Der erste Befehl ruft die VmTemplate01-Vorlage für virtuelle Computer ab und speichert dieses Objekt dann in der $VMTemplate Variablen.

Der zweite Befehl ruft die virtuellen COM-Portobjekte für VMTemplate01 ab und zeigt Informationen zu diesen Ports an.

Beispiel 3: Abrufen von COM-Ports für ein Hardwareprofil

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

Der erste Befehl ruft das Hardwareprofil mit dem Namen NewHWProfile01 ab und speichert dieses Objekt dann in der $HWProfile Variablen.

Der zweite Befehl ruft die virtuellen COM-Portobjekte für NewHWProfile01 ab und zeigt Informationen zu diesen Ports an.

Parameter

-All

Gibt an, dass dieses Cmdlet unabhängig vom übergeordneten Objekt eine vollständige Liste untergeordneter COM-Ports abruft.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

Typ:HardwareProfile
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VM

Gibt einen virtuellen Computer an, für den dieses Cmdlet virtuelle COM-Ports abruft. Verwenden Sie zum Abrufen eines virtuellen Computerobjekts das cmdlet Get-SCVirtualMachine.

Typ:VM
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMTemplate

Gibt eine VMM-Vorlage an, die zum Erstellen virtueller Computer verwendet wird, für die dieses Cmdlet virtuelle COM-Ports abruft. Verwenden Sie zum Abrufen eines VMM-Vorlagenobjekts das cmdlet Get-SCVMTemplate.

Typ:Template
Aliase:Template
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

VirtualCOMPort

Dieses Cmdlet gibt ein VirtualCOMPort--Objekt zurück.