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).

Una porta COM virtuale può connettersi a una porta fisica in un server host di macchine virtuali, 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 le 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 l'oggetto nella variabile $VM.

Il secondo comando ottiene gli oggetti porta COM virtuali 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 virtuali 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 virtuali 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.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-HardwareProfile

Specifica un oggetto profilo hardware.

Tipo:HardwareProfile
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly: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 .

Tipo:VM
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VMMServer

Specifica un oggetto server VMM.

Tipo:ServerConnection
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VMTemplate

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

Tipo:Template
Alias:Template
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Output

VirtualCOMPort

Questo cmdlet restituisce un oggetto VirtualCOMPort .