Compartilhar via

Get-SCVirtualCOMPort

  • Referência
Módulo:
VirtualMachineManager

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

Sintaxe

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 de porta COM (comunicação virtual). Esse 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 gerenciado pelo VMM (Virtual Machine Manager).

Uma porta COM virtual pode se conectar a uma porta física em um servidor host de máquina virtual, a um arquivo de texto ou a um pipe nomeado. Cada máquina virtual, modelo de máquina virtual e perfil de hardware contém exatamente duas portas COM.

Exemplos

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

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

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

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

Exemplo 2: Obter portas COM para um modelo

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

O primeiro comando obtém o modelo de máquina virtual chamado VMTemplate01 e armazena esse objeto na variável $VMTemplate.

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

Exemplo 3: Obter 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 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 essas portas.

Parâmetros

-All

Indica que esse cmdlet obtém uma lista completa de portas COM subordinadas independentemente do objeto pai.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-HardwareProfile

Especifica um objeto de perfil de hardware.

Tipo:HardwareProfile
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VM

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

Tipo:VM
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMTemplate

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

Tipo:Template
Aliases:Template
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

VirtualCOMPort

Esse cmdlet retorna um objeto VirtualCOMPort.