Condividi tramite

Get-SCVirtualCOMPort

  • Riferimento
Modulo:
VirtualMachineManager

Ottiene una porta COM virtuale da una macchina virtuale, un modello di macchina virtuale o un profilo hardware.

Sintassi

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

Descrizione

Il cmdlet Get-SCVirtualCOMPort ottiene oggetti porta COM (Virtual Communication). Questo cmdlet ottiene una o entrambe le porte COM da un oggetto macchina virtuale, un oggetto modello di macchina virtuale o un oggetto profilo hardware gestito da Virtual Machine Manager (VMM).

È possibile connettere una porta COM virtuale a una porta fisica in un server host macchina virtuale, a un file di testo o a una named pipe. Ogni macchina virtuale, modello di macchina virtuale e profilo hardware contiene esattamente due porte COM.

Esempio

Esempio 1: Ottenere porte COM per una macchina virtuale

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

Il primo comando ottiene la macchina virtuale denominata VM01 e quindi archivia tale oggetto nella variabile $VM.

Il secondo comando ottiene gli oggetti porta COM virtuale in VM01 e visualizza informazioni su queste porte.

Esempio 2: Ottenere porte COM per un modello

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

Il primo comando ottiene il modello di macchina virtuale denominato VMTemplate01 e quindi archivia tale oggetto nella variabile $VMTemplate.

Il secondo comando ottiene gli oggetti porta COM virtuale per VMTemplate01 e visualizza informazioni su queste porte.

Esempio 3: Ottenere porte COM per un profilo hardware

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

Il primo comando ottiene il profilo hardware denominato NewHWProfile01 e quindi archivia tale oggetto nella variabile $HWProfile.

Il secondo comando ottiene gli oggetti porta COM virtuale per NewHWProfile01 e visualizza informazioni su queste porte.

Parametri

-All

Indica che questo cmdlet ottiene un elenco completo di porte COM subordinate indipendenti dall'oggetto padre.

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

-HardwareProfile

Specifica un oggetto profilo hardware.

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

-VM

Specifica una macchina virtuale per cui questo cmdlet ottiene le porte COM virtuali. Per ottenere un oggetto macchina virtuale, usare il cmdlet Get-SCVirtualMachine .

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

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

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

-VMTemplate

Specifica un modello VMM usato per creare macchine virtuali per cui questo cmdlet ottiene porte COM virtuali. Per ottenere un oggetto modello VMM, usare il cmdlet Get-SCVMTemplate .

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

Output

VirtualCOMPort

Questo cmdlet restituisce un oggetto VirtualCOMPort .