Get-SCVirtualCOMPort

Модуль:
VirtualMachineManager Module

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

Синтаксис

All 

Get-SCVirtualCOMPort
    [-VMMServer <ServerConnection>]
    [-All]
    [<CommonParameters>]

HardwareProfile 

Get-SCVirtualCOMPort
    -HardwareProfile <HardwareProfile>
    [<CommonParameters>]

VM 

Get-SCVirtualCOMPort
    -VM <VM>
    [<CommonParameters>]

Template 

Get-SCVirtualCOMPort
    -VMTemplate <Template>
    [<CommonParameters>]

Описание

Командлет Get-SCVirtualCOMPort получает объекты портов виртуальной связи (COM). Этот командлет получает один или оба COM-порта от объекта виртуальной машины, объекта шаблона виртуальной машины или объекта профиля оборудования, которым управляет диспетчер виртуальных машин (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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

All
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-HardwareProfile

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

Свойства параметра

Тип:HardwareProfile
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

HardwareProfile
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VM

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

Свойства параметра

Тип:VM
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

VM
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMMServer

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

Свойства параметра

Тип:ServerConnection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

All
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMTemplate

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

Свойства параметра

Тип:Template
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:Шаблон

Наборы параметров

Template
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

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

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

VirtualCOMPort

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