Set-SCVirtualCOMPort
Modifica as propriedades de uma porta COM virtual para uma máquina virtual, um modelo de máquina virtual ou um 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 COM (comunicações virtuais). Uma porta COM virtual faz parte de uma máquina virtual, modelo de máquina virtual ou perfil de hardware usado em um ambiente do VMM (Virtual Machine Manager). Especifique uma porta COM usando o parâmetro VirtualCOMPort ou especifique uma ID de porta COM virtual para o parâmetro GuestPort . Os valores válidos para GuestPort são zero (0) e um (1).
Esse cmdlet pode conectar uma porta COM virtual a uma porta COM física, a um arquivo de texto ou a um pipe nomeado. Esse cmdlet pode desconectar uma porta COM virtual. Se você conectar uma porta COM virtual em uma máquina virtual a uma porta COM física em seu host, a máquina virtual poderá usar a porta COM física para entrada e saída. Os tipos de host dão suporte aos seguintes tipos de conexão de porta COM virtual:
- Hyper-V. Conecta-se somente a um pipe nomeado.
- VMware ESX. Conecta-se a uma porta COM física, arquivo de texto ou pipe nomeado.
- Citrix XenServer. Sem suporte.
O parâmetro WaitForModem especifica se uma porta COM virtual em uma máquina virtual se conecta imediatamente a uma porta COM física no host quando a máquina virtual é iniciada.
Se você especificar um valor de $True para WaitForModem, a máquina virtual tentará se conectar à porta COM física no host somente se um programa executado na máquina virtual enviar um comando de modem para a porta COM física. Se a porta COM no host já estiver conectada, a máquina virtual não poderá se conectar a ela. Se a máquina virtual se conectar com êxito à porta COM física, a máquina virtual mais tarde liberará a porta COM física de volta para o sistema operacional host se o programa na máquina virtual que usa a porta COM parar de usar a porta COM.
Se você especificar um valor de $False para WaitForModem, a máquina virtual tentará se conectar à porta COM física no host assim que a máquina virtual for iniciada. Se a porta COM no host já estiver capturada, a máquina virtual não poderá se conectar a ela. Esse é o mesmo comportamento de um valor de $True. Se a máquina virtual se conectar com êxito à porta COM física, a máquina virtual não liberará a porta COM física de volta para o sistema operacional host até que a máquina virtual seja desligada.
Exemplos
Exemplo 1: conectar uma porta COM virtual a um pipe 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 obtém a máquina virtual chamada VM02 e armazena esse objeto na variável $VM.
O segundo comando obtém a porta COM virtual chamada COM1 da VM02 e armazena esse objeto na variável $COM 1.
O último comando conecta a porta COM virtual em $COM 1 ao pipe nomeado \Contoso\Pipe\PipeName.
Exemplo 2: desconectar 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 obtém a máquina virtual chamada VM04 e armazena esse objeto na variável $VM.
O segundo comando obtém a porta COM virtual na VM04 chamada COM1 e armazena esse objeto na variável $COM 1.
O último comando especifica o parâmetro NoAttach . Isso faz com que o comando desconecte a porta COM virtual em $COM 1. Você pode usar esse comando para desconectar uma porta COM virtual que está atualmente conectada a uma porta COM física em um host, a um pipe nomeado ou a um arquivo de texto.
Parâmetros
-GuestPort
Especifica a ID de uma porta COM virtual em uma 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 são executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica uma variável na qual 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 pipe nomeado ao qual uma porta COM virtual se conecta. Os usos típicos incluem conectar uma máquina virtual a um programa de depuração no host. Você também pode criar um cabo de modem nulo virtual entre duas máquinas virtuais. Especifique um pipe 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 em um host, pipe nomeado ou arquivo se conecta a uma porta COM virtual. Se você especificar esse parâmetro, o cmdlet desconectará uma porta COM virtual que já está conectada a uma porta COM física, a um pipe nomeado ou a um arquivo de texto.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica do PRO (Performance and Resource Optimization) que disparou a ação. Isso 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 é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TextFile
Especifica um arquivo de texto no host ao qual a porta COM virtual se conecta. A máquina virtual envia a saída da porta COM virtual do arquivo de texto especificado por esse parâmetro. O arquivo de texto pode estar em qualquer unidade de disco válida no host.
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 dá suporte à configuração de duas portas COM em uma 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 em um servidor host ao qual a máquina virtual pode conectar 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 do 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 em uma máquina virtual se conecta imediatamente a uma porta COM física no host quando a máquina virtual é iniciada.
Se você especificar um valor de $True, a porta COM virtual aguardará para se conectar a uma porta COM física no host. Se você especificar um valor de $False, a porta COM virtual se conectará imediatamente a uma porta COM física no host assim que a máquina virtual for iniciada.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Saídas
VirtualCOMPort
Este cmdlet retorna um objeto VirtualCOMPort .
Observações
- Requer um objeto de porta COM virtual do VMM. Você pode recuperar esse objeto usando o cmdlet Get-SCVirtualCOMPort .