Partilhar via

Set-SCVirtualCOMPort

  • Referência
Módulo:
VirtualMachineManager

Modifica as propriedades de uma porta COM virtual para uma máquina virtual, modelo de máquina virtual ou perfil de hardware.

Syntax

Set-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   -GuestPort <Byte>
   -VMHostCOMPort <Byte>
   [-WaitForModem <Boolean>]
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   -GuestPort <Byte>
   -TextFile <String>
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   -GuestPort <Byte>
   [-NoAttach]
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   -GuestPort <Byte>
   -NamedPipe <String>
   -JobGroup <Guid>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VirtualCOMPort] <VirtualCOMPort>
   -TextFile <String>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VirtualCOMPort] <VirtualCOMPort>
   [-NoAttach]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VirtualCOMPort] <VirtualCOMPort>
   -VMHostCOMPort <Byte>
   [-WaitForModem <Boolean>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualCOMPort
   [-VirtualCOMPort] <VirtualCOMPort>
   -NamedPipe <String>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVirtualCOMPort modifica uma ou mais propriedades de uma porta de comunicações virtuais (COM). Uma porta COM virtual faz parte de uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado num ambiente virtual de Gestor de Máquinas (VMM). Especifique uma porta COM utilizando o parâmetro VirtualCOMPort ou especifique um ID de porta COM virtual para o parâmetro GuestPort . Os valores válidos para GuestPort são zero (0) e um (1).

Este cmdlet pode ligar uma porta COM virtual a uma porta COM física, a um ficheiro de texto ou a um tubo nomeado. Este cmdlet pode desligar uma porta COM virtual. Se ligar uma porta COM virtual a uma máquina virtual a uma porta COM física no seu hospedeiro, a máquina virtual pode utilizar a porta COM física para entrada e saída. Os tipos de anfitrião suportam os seguintes tipos de ligação com a porta COM virtual:

  • Hiper-V. Liga-se apenas a um tubo com nome.
  • VMware ESX. Liga-se a uma porta COM física, ficheiro de texto ou tubo nomeado.
  • Citrix XenServer. Não suportado.

O parâmetro WaitForModem especifica se uma porta COM virtual numa máquina virtual se liga imediatamente a uma porta COM física no hospedeiro quando a máquina virtual começa.

Se especificar um valor de $True para WaitForModem, a máquina virtual tenta ligar-se à porta COM física no hospedeiro apenas se um programa que funciona na máquina virtual enviar um comando de modem para a porta COM física. Se a porta COM do hospedeiro já estiver ligada, a máquina virtual não pode ligar-se a ela. Se a máquina virtual ligar-se com sucesso à porta COM física, a máquina virtual liberta mais tarde a porta COM física para o sistema operativo anfitrião se o programa na máquina virtual que utiliza a porta COM parar de utilizar a porta COM.

Se especificar um valor de $False para WaitForModem, a máquina virtual tenta ligar-se à porta COM física no hospedeiro assim que a máquina virtual começa. Se a porta COM do hospedeiro já estiver capturada, a máquina virtual não pode ligar-se a ele. Este é o mesmo comportamento que para um valor de $True. Se a máquina virtual se ligar com sucesso à porta COM física, a máquina virtual não liberta a porta COM física de volta ao sistema operativo anfitrião até que a máquina virtual seja desligada.

Exemplos

Exemplo 1: Ligue uma porta COM virtual a um tubo nomeado

PS C:\> $VM = Get-SCVirtualMachine -Name "VM02"
PS C:\> $COM1 = Get-SCVirtualCOMPort -VM $VM | where {$_.Name -eq "COM1"}
PS C:\> Set-SCVirtualCOMPort -VirtualCOMPort $COM1 -NamedPipe "\\Contoso\Pipe\PipeName"

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

O segundo comando recebe a porta COM virtual chamada COM1 de VM02, e depois armazena esse objeto na variável $COM 1.

O último comando liga a porta COM virtual em $COM 1 ao tubo denominado \Contoso\Pipe\PipeName.

Exemplo 2: Desligar uma porta COM virtual

PS C:\> $VM = Get-SCVirtualMachine -Name "VM04"
PS C:\> $COM1 = Get-SCVirtualCOMPort -VM $VM | where {$_.Name -eq "COM1"}
PS C:\> Set-SCVirtualCOMPort -VirtualCOMPort $COM1 -NoAttach

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

O segundo comando obtém a porta COM virtual em VM04 chamada COM1, e depois armazena esse objeto na variável $COM 1.

O último comando especifica o parâmetro NoAttach . Isto faz com que o comando desligue a porta COM virtual em $COM 1. Pode utilizar este comando para desligar uma porta COM virtual que está atualmente ligada a uma porta COM física num hospedeiro, a um tubo nomeado ou a um ficheiro de texto.

Parâmetros

-GuestPort

Especifica o ID de uma porta COM virtual numa máquina virtual. Os valores válidos são: 0 e 1.

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

-JobGroup

Especifica um identificador para uma série de comandos que funciona como um conjunto pouco antes do comando final que inclui o mesmo identificador do grupo de trabalho.

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

-JobVariable

Especifica uma variável em que o progresso do trabalho é rastreado e armazenado.

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

-NamedPipe

Especifica um tubo nomeado ao qual uma porta COM virtual se conecta. As utilizações típicas incluem ligar uma máquina virtual a um programa de depuragem no anfitrião. Também pode criar um cabo de modem nulo virtual entre duas máquinas virtuais. Especificar um tubo no seguinte formato: \\ComputerName\Pipe\PipeName

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

-NoAttach

Indica que este cmdlet especifica que nenhuma porta COM física num hospedeiro, um tubo nomeado ou um ficheiro se ligam a uma porta COM virtual. Se especificar este parâmetro, o cmdlet desliga uma porta COM virtual que já está ligada a uma porta COM física, a um tubo nomeado ou a um ficheiro de texto.

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

-PROTipID

Especifica o ID da ponta de Otimização de Desempenho e Recursos (PRO) que desencadeou esta ação. Isto permite a auditoria de dicas PRO.

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

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

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

-TextFile

Especifica um ficheiro de texto no anfitrião ao qual a porta COM virtual se conecta. A máquina virtual envia saída da porta COM virtual do ficheiro de texto que este parâmetro especifica. O ficheiro de texto pode estar em qualquer unidade de disco válida no anfitrião.

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

-VirtualCOMPort

Especifica um objeto de porta COM virtual que este cmdlet modifica. O VMM suporta a configuração de duas portas COM numa máquina virtual, modelo ou perfil de hardware.

Type:VirtualCOMPort
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHostCOMPort

Especifica um objeto de porta COM físico num servidor anfitrião ao qual a máquina virtual pode ligar uma porta COM virtual.

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

-VMMServer

Especifica um servidor VMM.

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

-WaitForModem

Indica se uma porta COM virtual numa máquina virtual se liga imediatamente a uma porta COM física no hospedeiro quando a máquina virtual começa.

Se especificar um valor de $True, a porta COM virtual espera para ligar a uma porta COM física no hospedeiro. Se especificar um valor de $False, a porta COM virtual liga-se imediatamente a uma porta COM física no hospedeiro assim que a máquina virtual começa.

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

Saídas

VirtualCOMPort

Este cmdlet devolve um objeto VirtualCOMPort .

Notas

  • Requer um objeto de porta COM virtual VMM. Pode recuperar este objeto utilizando o cmdlet Get-SCVirtualCOMPort .