Get-SCVirtualCOMPort

가상 머신, 가상 머신 템플릿 또는 하드웨어 프로필에서 가상 COM 포트를 가져옵니다.

Syntax

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

Description

Get-SCVirtualCOMPort cmdlet은 COM(가상 통신) 포트 개체를 가져옵니다. 이 cmdlet은 가상 머신 개체, 가상 머신 템플릿 개체 또는 VMM(Virtual Machine Manager)에서 관리하는 하드웨어 프로필 개체에서 하나 또는 둘 다 COM 포트를 가져옵니다.

가상 COM 포트는 가상 컴퓨터 호스트 서버의 실제 포트, 텍스트 파일 또는 명명된 파이프에 연결할 수 있습니다. 각 가상 머신, 가상 머신 템플릿 및 하드웨어 프로필에는 정확히 두 개의 COM 포트가 포함됩니다.

예제

예제 1: 가상 머신에 대한 COM 포트 가져오기

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

첫 번째 명령은 VM01이라는 가상 머신을 가져온 다음 해당 개체를 $VM 변수에 저장합니다.

두 번째 명령은 VM01에서 가상 COM 포트 개체를 가져오고 이러한 포트에 대한 정보를 표시합니다.

예제 2: 템플릿에 대한 COM 포트 가져오기

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

첫 번째 명령은 VMTemplate01이라는 가상 머신 템플릿을 가져온 다음 해당 개체를 $VMTemplate 변수에 저장합니다.

두 번째 명령은 VMTemplate01에 대한 가상 COM 포트 개체를 가져오고 이러한 포트에 대한 정보를 표시합니다.

예제 3: 하드웨어 프로필에 대한 COM 포트 가져오기

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

첫 번째 명령은 NewHWProfile01이라는 하드웨어 프로필을 가져오고 해당 개체를 $HWProfile 변수에 저장합니다.

두 번째 명령은 NewHWProfile01에 대한 가상 COM 포트 개체를 가져오고 이러한 포트에 대한 정보를 표시합니다.

매개 변수

-All

이 cmdlet은 부모 개체와 독립적으로 하위 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

이 cmdlet이 가상 COM 포트를 가져오는 가상 머신을 지정합니다. 가상 머신 개체를 가져오려면 Get-SCVirtualMachine cmdlet을 사용합니다.

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

이 cmdlet이 가상 COM 포트를 가져오는 가상 머신을 만드는 데 사용되는 VMM 템플릿을 지정합니다. VMM 템플릿 개체를 가져오려면 Get-SCVMTemplate cmdlet을 사용합니다.

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

출력

VirtualCOMPort

이 cmdlet은 VirtualCOMPort 개체를 반환합니다.