Get-SCVirtualCOMPort

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 Portobjekte (Virtual Communication, COM) ab. Dieses Cmdlet ruft einen oder beide COM-Ports von einem virtuellen Computerobjekt, einem Vorlagenobjekt eines virtuellen Computers oder einem Hardwareprofilobjekt ab, das Virtual Machine Manager (VMM) verwaltet.

Ein virtueller COM-Anschluss kann eine Verbindung mit einem physikalischen Anschluss am Hostserver für virtuelle Maschinen, mit einer Textdatei oder mit einer Named Pipe herstellen. Jede virtuelle Maschine, die Vorlage für virtuelle Computer und das 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 mit dem Namen 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 "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 eine vollständige Liste der untergeordneten COM-Ports abruft, unabhängig vom übergeordneten Objekt.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-HardwareProfile

Gibt ein Hardwareprofilobjekt an.

Type:HardwareProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 .

Type:VM
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMTemplate

Gibt eine VMM-Vorlage an, die zum Erstellen virtueller Computer verwendet wird, für die dieses Cmdlet virtuelle COM-Ports abruft. Um ein VMM-Vorlagenobjekt abzurufen, verwenden Sie das Cmdlet Get-SCVMTemplate .

Type:Template
Aliases:Template
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Ausgaben

VirtualCOMPort

Dieses Cmdlet gibt ein VirtualCOMPort-Objekt zurück.