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.

Sintaxis

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 se admite.

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 se puede conectar a él. 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 tan pronto como se inicie 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.

Tipo:Byte
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NamedPipe

Especifica una canalización con nombre a la que se conecta un puerto COM virtual. Entre los usos típicos se incluye 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 formato siguiente: \.\NombreDeEquipo\Pipe\PipeName

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NoAttach

Indica que este cmdlet especifica que ningún puerto COM físico en un host, una canalización con nombre o un 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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

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

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 del archivo de texto que especifica este parámetro. El archivo de texto puede estar en cualquier unidad de disco válida en el host.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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, una plantilla o un perfil de hardware.

Tipo:VirtualCOMPort
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Byte
Alias:HostPort
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMMServer

Especifica un servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.