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 Virtual Machine Manager (VMM) hanterar.

En virtuell COM-port kan ansluta till en fysisk port på en virtuell dators värdserver, till en textfil eller till ett namngivet rör. 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 den virtuella datorn 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 den här cmdleten hämtar en fullständig lista över underordnade COM-portar oberoende av det överordnade objektet.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-HardwareProfile

Anger ett maskinvaruprofilobjekt.

Typ:HardwareProfile
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:VM
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VMMServer

Anger ett VMM-serverobjekt.

Typ:ServerConnection
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VMTemplate

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

Typ:Template
Alias:Template
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Utdata

VirtualCOMPort

Den här cmdleten returnerar ett VirtualCOMPort- objekt.