Поделиться через

Get-SCVirtualCOMPort

  • Ссылка
Модуль:
VirtualMachineManager

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

Синтаксис

Get-SCVirtualCOMPort
   [-VMMServer <ServerConnection>]
   [-All]
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -HardwareProfile <HardwareProfile>
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -VM <VM>
   [<CommonParameters>]
Get-SCVirtualCOMPort
   -VMTemplate <Template>
   [<CommonParameters>]

Описание

Командлет Get-SCVirtualCOMPort получает объекты портов виртуальной связи (COM). Этот командлет получает один или оба COM-порта из объекта виртуальной машины, объекта шаблона виртуальной машины или объекта профиля оборудования, которым управляет Virtual Machine Manager (VMM).

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

Примеры

Пример 1. Получение COM-портов для виртуальной машины

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> Get-SCVirtualCOMPort -VM $VM

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

Вторая команда получает объекты виртуального COM-порта на VM01 и отображает сведения об этих портах.

Пример 2. Получение COM-портов для шаблона

PS C:\> $VMTemplate = Get-SCVMTemplate | where { $_.Name -eq "VMTemplate01" }
PS C:\> Get-SCVirtualCOMPort -VMTemplate $VMTemplate

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

Вторая команда получает объекты виртуального COM-порта для VMTemplate01 и отображает сведения об этих портах.

Пример 3. Получение COM-портов для профиля оборудования

PS C:\> $HWProfile = Get-SCHardwareProfile | where { $_.Name -eq "NewHWProfile01" }
PS C:\> Get-SCVirtualCOMPort -HardwareProfile $HWProfile

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

Вторая команда получает объекты виртуального COM-порта для NewHWProfile01 и отображает сведения об этих портах.

Параметры

-All

Указывает, что этот командлет получает полный список подчиненных COM-портов независимо от родительского объекта.

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

-HardwareProfile

Указывает объект профиля оборудования.

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

-VM

Указывает виртуальную машину, для которой этот командлет получает виртуальные COM-порты. Чтобы получить объект виртуальной машины, используйте командлет Get-SCVirtualMachine .

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

-VMMServer

Указывает объект сервера VMM.

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

-VMTemplate

Указывает шаблон VMM, используемый для создания виртуальных машин, для которых этот командлет получает виртуальные COM-порты. Чтобы получить объект шаблона VMM, используйте командлет Get-SCVMTemplate .

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

Выходные данные

VirtualCOMPort

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