Partilhar via

Get-SCVirtualCOMPort

  • Referência
Módulo:
VirtualMachineManager

Obtém uma porta COM virtual a partir de uma máquina virtual, um modelo de máquina virtual ou um perfil de hardware.

Syntax

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

Description

O cmdlet get-SCVirtualCOMPort obtém objetos porta de comunicação virtual (COM). Este cmdlet obtém uma ou ambas as portas COM de um objeto de máquina virtual, um objeto de modelo de máquina virtual ou um objeto de perfil de hardware que o Virtual Machine Manager (VMM) gere.

Uma porta COM virtual pode ligar-se a uma porta física num servidor de anfitrião de máquinas virtuais, a um ficheiro de texto ou a um tubo nomeado. Cada máquina virtual, modelo de máquina virtual e perfil de hardware contém exatamente duas portas COM.

Exemplos

Exemplo 1: Obtenha portas COM para uma máquina virtual

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

O primeiro comando recebe a máquina virtual chamada VM01, e depois armazena esse objeto na variável $VM.

O segundo comando obtém os objetos de porta COM virtuais em VM01 e exibe informações sobre estas portas.

Exemplo 2: Obtenha portas COM para um modelo

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

O primeiro comando recebe o modelo de máquina virtual chamado VMTemplate01 e, em seguida, armazena esse objeto na variável $VMTemplate.

O segundo comando obtém os objetos de porta COM virtuais para VMTemplate01 e apresenta informações sobre estas portas.

Exemplo 3: Obtenha portas COM para um perfil de hardware

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

O primeiro comando obtém o perfil de hardware chamado NewHWProfile01, e depois armazena esse objeto na variável $HWProfile.

O segundo comando obtém os objetos de porta COM virtuais para NewHWProfile01 e exibe informações sobre estas portas.

Parâmetros

-All

Indica que este cmdlet obtém uma lista completa de portas COM subordinadas independentes do objeto-mãe.

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

-HardwareProfile

Especifica um objeto de perfil de hardware.

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

-VM

Especifica uma máquina virtual para a qual este cmdlet obtém portas COM virtuais. Para obter um objeto de máquina virtual, utilize o cmdlet Get-SCVirtualMachine .

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

-VMMServer

Especifica um objeto de servidor VMM.

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

-VMTemplate

Especifica um modelo VMM que é usado para criar máquinas virtuais para as quais este cmdlet obtém portas COM virtuais. Para obter um objeto de modelo VMM, utilize o cmdlet Get-SCVMTemplate .

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

Saídas

VirtualCOMPort

Este cmdlet devolve um objeto VirtualCOMPort .