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

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-портов независимо от родительского объекта.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-HardwareProfile

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

Тип:HardwareProfile
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VM

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

Тип:VM
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VMMServer

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

Тип:ServerConnection
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VMTemplate

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

Тип:Template
Aliases:Template
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

VirtualCOMPort

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