Dela via

Get-SCVirtualCOMPort

  • Referens
Modul:
VirtualMachineManager

Hämtar en virtuell COM-port från en virtuell dator, en mall för virtuella datorer eller en maskinvaruprofil.

Syntax

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

Description

Cmdleten Get-SCVirtualCOMPort hämtar portobjekt för virtuell kommunikation (COM). Den här cmdleten hämtar en eller båda COM-portarna från ett virtuellt datorobjekt, ett mallobjekt för virtuell dator eller ett maskinvaruprofilobjekt som Hanteras av Virtual Machine Manager (VMM).

En virtuell COM-port kan ansluta till en fysisk port på en virtuell dators värdserver, till en textfil eller till en namngiven pipe. Varje virtuell dator, mall för virtuella datorer och maskinvaruprofil innehåller exakt två COM-portar.

Exempel

Exempel 1: Hämta COM-portar för en virtuell dator

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

Det första kommandot hämtar den virtuella datorn med namnet VM01 och lagrar sedan objektet i variabeln $VM.

Det andra kommandot hämtar de virtuella COM-portobjekten på VM01 och visar information om dessa portar.

Exempel 2: Hämta COM-portar för en mall

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

Det första kommandot hämtar mallen för virtuella datorer med namnet VMTemplate01 och lagrar sedan objektet i variabeln $VMTemplate.

Det andra kommandot hämtar de virtuella COM-portobjekten för VMTemplate01 och visar information om dessa portar.

Exempel 3: Hämta COM-portar för en maskinvaruprofil

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

Det första kommandot hämtar maskinvaruprofilen med namnet NewHWProfile01 och lagrar sedan objektet i variabeln $HWProfile.

Det andra kommandot hämtar de virtuella COM-portobjekten för NewHWProfile01 och visar information om dessa portar.

Parametrar

-All

Anger att denna cmdlet hämtar en fullständig lista över underordnade COM-portar oberoende av det överordnade objektet.

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

-HardwareProfile

Anger ett maskinvaruprofilobjekt.

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

-VM

Anger en virtuell dator som den här cmdleten hämtar virtuella COM-portar för. Om du vill hämta ett virtuellt datorobjekt använder du cmdleten Get-SCVirtualMachine .

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

-VMMServer

Anger ett VMM-serverobjekt.

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

-VMTemplate

Anger en VMM-mall som används för att skapa virtuella datorer som denna cmdlet hämtar virtuella COM-portar för. Om du vill hämta ett VMM-mallobjekt använder du cmdleten Get-SCVMTemplate .

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

Utdata

VirtualCOMPort

Den här cmdleten returnerar ett VirtualCOMPort-objekt .