Compartir a través de

Set-SCVirtualCOMPort

  • Referencia
Módulo:
VirtualMachineManager

Modifica las propiedades de un puerto COM virtual para una máquina virtual, una plantilla de máquina virtual o un 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

El cmdlet Set-SCVirtualCOMPort modifica una o varias propiedades de un puerto de comunicaciones virtuales (COM). Un puerto COM virtual forma parte de una máquina virtual, una plantilla de máquina virtual o un perfil de hardware que se usa en un entorno de Virtual Machine Manager (VMM). Especifique un puerto COM mediante el parámetro VirtualCOMPort o especifique un identificador de puerto COM virtual para el parámetro GuestPort . Los valores válidos para GuestPort son cero (0) y uno (1).

Este cmdlet puede conectar un puerto COM virtual a un puerto COM físico, a un archivo de texto o a una canalización con nombre. Este cmdlet puede desconectar un puerto COM virtual. Si conecta un puerto COM virtual en una máquina virtual a un puerto COM físico en su host, la máquina virtual puede usar el puerto COM físico para la entrada y salida. Los tipos de host admiten los siguientes tipos de conexión de puerto COM virtual:

  • Hyper-V. Se conecta solo a una canalización con nombre.
  • VMware ESX. Se conecta a un puerto COM físico, un archivo de texto o una canalización con nombre.
  • Citrix XenServer. No compatible.

El parámetro WaitForModem especifica si un puerto COM virtual de una máquina virtual se conecta inmediatamente a un puerto COM físico en el host cuando se inicia la máquina virtual.

Si especifica un valor de $True para WaitForModem, la máquina virtual intenta conectarse al puerto COM físico en el host solo si un programa que se ejecuta en la máquina virtual envía un comando módem al puerto COM físico. Si el puerto COM del host ya está conectado, la máquina virtual no puede conectarse a este. Si la máquina virtual se conecta correctamente al puerto COM físico, la máquina virtual libera posteriormente el puerto COM físico al sistema operativo host si el programa de la máquina virtual que usa el puerto COM deja de usar el puerto COM.

Si especifica un valor de $False para WaitForModem, la máquina virtual intenta conectarse al puerto COM físico en el host en cuanto se inicia la máquina virtual. Si el puerto COM del host ya está capturado, la máquina virtual no se puede conectar a él. Este es el mismo comportamiento que para un valor de $True. Si la máquina virtual se conecta correctamente al puerto COM físico, la máquina virtual no vuelve a liberar el puerto COM físico al sistema operativo host hasta que se apague la máquina virtual.

Ejemplos

Ejemplo 1: Conexión de un puerto COM virtual a una canalización con nombre

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"

El primer comando obtiene la máquina virtual denominada VM02 y, a continuación, almacena ese objeto en la variable $VM.

El segundo comando obtiene el puerto COM virtual denominado COM1 de VM02 y, a continuación, almacena ese objeto en la variable $COM 1.

El último comando conecta el puerto COM virtual de $COM 1 a la canalización con nombre \Contoso\Pipe\PipeName.

Ejemplo 2: Desconectar un puerto 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

El primer comando obtiene la máquina virtual denominada VM04 y, a continuación, almacena ese objeto en la variable $VM.

El segundo comando obtiene el puerto COM virtual en VM04 denominado COM1 y, a continuación, almacena ese objeto en la variable $COM 1.

El último comando especifica el parámetro NoAttach . Esto hace que el comando desconecte el puerto COM virtual en $COM 1. Puede usar este comando para desconectar un puerto COM virtual que está conectado actualmente a un puerto COM físico en un host, a una canalización con nombre o a un archivo de texto.

Parámetros

-GuestPort

Especifica el identificador de un puerto COM virtual en una máquina virtual. Los valores válidos son: 0 y 1.

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

-JobGroup

Especifica un identificador para una serie de comandos que se ejecuta como un conjunto justo antes de que se ejecute el mismo identificador de grupo de trabajos.

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

-JobVariable

Especifica una variable en la que se realiza un seguimiento del progreso del trabajo y se almacena.

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

-NamedPipe

Especifica una canalización con nombre a la que se conecta un puerto COM virtual. Los usos típicos incluyen la conexión de una máquina virtual a un programa de depuración en el host. También puede crear un cable de módem nulo virtual entre dos máquinas virtuales. Especifique una canalización con el siguiente formato: \.\NombreDeEquipo\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 ningún puerto COM físico en un host, canalización con nombre o archivo se conecte a un puerto COM virtual. Si especifica este parámetro, el cmdlet desconecta un puerto COM virtual que ya está conectado a un puerto COM físico, a una canalización con nombre o a un archivo de texto.

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

-PROTipID

Especifica el identificador de la sugerencia de Optimización de rendimiento y recursos (PRO) que desencadenó esta acción. Esto permite la auditoría de sugerencias pro.

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

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.

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

-TextFile

Especifica un archivo de texto en el host al que se conecta el puerto COM virtual. La máquina virtual envía la salida del puerto COM virtual que especifica este parámetro. El archivo de texto puede estar en cualquier unidad de disco válida del host.

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

-VirtualCOMPort

Especifica un objeto de puerto COM virtual que modifica este cmdlet. VMM admite la configuración de dos puertos COM en una máquina virtual, plantilla o perfil de hardware.

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

-VMHostCOMPort

Especifica un objeto de puerto COM físico en un servidor host al que la máquina virtual puede conectar un puerto COM virtual.

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

-VMMServer

Especifica un servidor VMM.

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

-WaitForModem

Indica si un puerto COM virtual de una máquina virtual se conecta inmediatamente a un puerto COM físico en el host cuando se inicia la máquina virtual.

Si especifica un valor de $True, el puerto COM virtual espera a conectarse a un puerto COM físico en el host. Si especifica un valor de $False, el puerto COM virtual se conecta inmediatamente a un puerto COM físico en el host en cuanto se inicia la máquina virtual.

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

Salidas

VirtualCOMPort

Este cmdlet devuelve un objeto VirtualCOMPort .

Notas

  • Requiere un objeto de puerto COM virtual VMM. Puede recuperar este objeto mediante el cmdlet Get-SCVirtualCOMPort .