Set-SCVirtualCOMPort

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

Set-SCVirtualCOMPort
    -GuestPort <Byte>
    -TextFile <String>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Set-SCVirtualCOMPort
    -GuestPort <Byte>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-NoAttach]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Set-SCVirtualCOMPort
    -GuestPort <Byte>
    -NamedPipe <String>
    -JobGroup <Guid>
    [-VMMServer <ServerConnection>]
    [-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>]

Командлет Set-SCVirtualCOMPort изменяет одно или несколько свойств порта виртуальной связи (COM). Виртуальный COM-порт является частью виртуальной машины, шаблона виртуальной машины или профиля оборудования, используемого в среде Virtual Machine Manager (VMM). Укажите COM-порт с помощью параметра VirtualCOMPort или укажите идентификатор виртуального COM-порта для параметра GuestPort . Допустимые значения для GuestPort : ноль (0) и один (1).

Этот командлет может подключать виртуальный COM-порт к физическому COM-порту, к текстовому файлу или к именованному каналу. Этот командлет может отключить виртуальный COM-порт. Если подключить виртуальный COM-порт на виртуальной машине к физическому COM-порту на ее хосте, виртуальная машина сможет использовать физический COM-порт для ввода и вывода. Типы хостов поддерживают следующие типы подключений к виртуальным COM-портам:

• Гипер-V. Подключается только к именованной трубе.
• VMware ESX. Подключается к физическому COM-порту, текстовому файлу или именованному каналу.
• Citrix XenServer. Не поддерживается

Параметр WaitForModem указывает, подключается ли виртуальный COM-порт на виртуальной машине непосредственно к физическому COM-порту на узле при запуске виртуальной машины.

Если указать значение $True для WaitForModem, виртуальная машина попытается подключиться к физическому COM-порту на узле только в том случае, если программа, работающая на виртуальной машине, отправит команду модема на физический COM-порт. Если COM-порт на узле уже подключен, виртуальная машина не сможет подключиться к нему. Если виртуальная машина успешно подключается к физическому COM-порту, виртуальная машина позже освобождает физический COM-порт обратно в операционную систему узла, если программа на виртуальной машине, использующей COM-порт, прекращает использование COM-порта.

Если указать значение $False для WaitForModem, виртуальная машина попытается подключиться к физическому COM-порту на узле сразу после запуска виртуальной машины. Если COM-порт на узле уже захвачен, виртуальная машина не сможет подключиться к нему. Это то же поведение, что и для значения $True. Если виртуальная машина успешно подключается к физическому COM-порту, виртуальная машина не освобождает физический COM-порт обратно в операционную систему узла до тех пор, пока виртуальная машина не будет выключена.

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"

Первая команда получает виртуальную машину с именем VM02, а затем сохраняет этот объект в переменной $VM.

Вторая команда получает виртуальный COM-порт с именем COM1 от VM02, а затем сохраняет этот объект в переменной $COM 1.

Последняя команда подключает виртуальный COM-порт в $COM 1 к именованному каналу \Contoso\Pipe\PipeName.

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

Первая команда получает виртуальную машину с именем VM04, а затем сохраняет этот объект в переменной $VM.

Вторая команда получает виртуальный COM-порт на VM04 с именем COM1, а затем сохраняет этот объект в переменной $COM 1.

Последняя команда задает параметр NoAttach . Это приведет к тому, что команда отключит виртуальный COM-порт в $COM 1. С помощью этой команды можно отключить виртуальный COM-порт, который в данный момент подключен к физическому COM-порту на узле, к именованному каналу или к текстовому файлу.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Этот командлет возвращает объект VirtualCOMPort .

• Требуется объект виртуального COM-порта VMM. Этот объект можно получить с помощью командлета Get-SCVirtualCOMPort .