Set-SCVirtualCOMPort

참조

모듈:: VirtualMachineManager

가상 머신, 가상 머신 템플릿 또는 하드웨어 프로필에 대한 가상 COM 포트의 속성을 수정합니다.

Syntax

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

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

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

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

Description

Set-SCVirtualCOMPort cmdlet은 COM(가상 통신) 포트의 하나 이상의 속성을 수정합니다. 가상 COM 포트는 VMM(Virtual Machine Manager) 환경에서 사용되는 가상 머신, 가상 머신 템플릿 또는 하드웨어 프로필의 일부입니다. VirtualCOMPort 매개 변수를 사용하여 COM 포트를 지정하거나 GuestPort 매개 변수에 대한 가상 COM 포트 ID를 지정합니다. GuestPort의 유효한 값은 0과 1입니다.

이 cmdlet은 가상 COM 포트를 실제 COM 포트, 텍스트 파일 또는 명명된 파이프에 연결할 수 있습니다. 이 cmdlet은 가상 COM 포트의 연결을 끊을 수 있습니다. 가상 머신의 가상 COM 포트를 호스트의 실제 COM 포트에 연결하는 경우 가상 머신은 입력 및 출력에 실제 COM 포트를 사용할 수 있습니다. 호스트 유형은 다음과 같은 가상 COM 포트 연결 형식을 지원합니다.

Hyper-V. 명명된 파이프에만 연결합니다.
VMware ESX. 실제 COM 포트, 텍스트 파일 또는 명명된 파이프에 연결합니다.
Citrix XenServer. 지원되지 않습니다.

WaitForModem 매개 변수는 가상 머신이 시작될 때 가상 머신의 가상 COM 포트가 호스트의 실제 COM 포트에 즉시 연결되는지 여부를 지정합니다.

WaitForModem에 대한 $True 값을 지정하면 가상 머신에서 실행되는 프로그램이 모뎀 명령을 실제 COM 포트로 보내는 경우에만 가상 머신이 호스트의 실제 COM 포트에 연결하려고 시도합니다. 호스트의 COM 포트가 이미 연결되어 있으면 가상 컴퓨터가 해당 포트에 연결할 수 없습니다. 가상 머신이 실제 COM 포트에 성공적으로 연결되면 COM 포트를 사용하는 가상 머신의 프로그램이 COM 포트 사용을 중지하는 경우 가상 머신은 나중에 실제 COM 포트를 호스트 운영 체제로 다시 해제합니다.

WaitForModem에 대한 $False 값을 지정하면 가상 머신이 시작되는 즉시 가상 머신이 호스트의 실제 COM 포트에 연결하려고 시도합니다. 호스트의 COM 포트가 이미 캡처된 경우 가상 머신은 이 포트에 연결할 수 없습니다. 이는 $True 값과 동일한 동작입니다. 가상 머신이 실제 COM 포트에 성공적으로 연결되면 가상 머신이 종료될 때까지 가상 머신이 실제 COM 포트를 호스트 운영 체제로 다시 릴리스하지 않습니다.

예제

예제 1: 명명된 파이프에 가상 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 변수에 저장합니다.

두 번째 명령은 VM02에서 COM1이라는 가상 COM 포트를 가져온 다음 해당 개체를 $COM 1 변수에 저장합니다.

마지막 명령은 $COM 1의 가상 COM 포트를 명명된 파이프 \Contoso\Pipe\PipeName에 연결합니다.

예제 2: 가상 COM 포트 연결 끊기

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 변수에 저장합니다.

두 번째 명령은 COM1이라는 VM04의 가상 COM 포트를 가져온 다음 해당 개체를 $COM 1 변수에 저장합니다.

마지막 명령은 NoAttach 매개 변수를 지정합니다. 이로 인해 명령은 $COM 1에서 가상 COM 포트의 연결을 끊습니다. 이 명령을 사용하면 호스트의 실제 COM 포트, 명명된 파이프 또는 텍스트 파일에 현재 연결되어 있는 가상 COM 포트의 연결을 끊을 수 있습니다.

매개 변수

-GuestPort

가상 머신에서 가상 COM 포트의 ID를 지정합니다. 유효한 값은 0과 1입니다.

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

-JobGroup

동일한 작업 그룹 식별자를 포함하는 최종 명령 바로 앞에 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.

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

-JobVariable

작업 진행률을 추적하고 저장하는 변수를 지정합니다.

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

-NamedPipe

가상 COM 포트가 연결되는 명명된 파이프를 지정합니다. 일반적인 용도로는 호스트의 디버깅 프로그램에 가상 머신을 연결하는 것이 포함됩니다. 두 가상 머신 간에 가상 null 모뎀 케이블을 만들 수도 있습니다. \.\ComputerName\Pipe\PipeName 형식으로 파이프를 지정합니다.

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

-NoAttach

이 cmdlet은 호스트, 명명된 파이프 또는 파일이 가상 COM 포트에 연결되지 않는 실제 COM 포트를 지정하지 않음을 나타냅니다. 이 매개 변수를 지정하면 cmdlet은 실제 COM 포트, 명명된 파이프 또는 텍스트 파일에 이미 연결된 가상 COM 포트의 연결을 끊습니다.

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

-PROTipID

이 작업을 트리거한 PRO(성능 및 리소스 최적화) 팁의 ID를 지정합니다. 이렇게 하면 PRO 팁을 감사할 수 있습니다.

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

-RunAsynchronously

컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.

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

-TextFile

가상 COM 포트가 연결되는 호스트의 텍스트 파일을 지정합니다. 가상 머신은 이 매개 변수가 지정하는 텍스트 파일을 가상 COM 포트에서 출력을 보냅니다. 텍스트 파일의 위치로는 호스트의 모든 유효한 디스크 드라이브라면 어디든 지정할 수 있습니다.

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

-VirtualCOMPort

이 cmdlet에서 수정하는 가상 COM 포트 개체를 지정합니다. VMM에서는 가상 컴퓨터, 템플릿 또는 하드웨어 프로필에 COM 포트를 두 개 구성할 수 있습니다.

Type:	VirtualCOMPort
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-VMHostCOMPort

가상 머신이 가상 COM 포트를 연결할 수 있는 호스트 서버의 실제 COM 포트 개체를 지정합니다.

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

-VMMServer

VMM 서버를 지정합니다.

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

-WaitForModem

가상 머신이 시작될 때 가상 머신의 가상 COM 포트가 호스트의 실제 COM 포트에 즉시 연결되는지 여부를 나타냅니다.

$True 값을 지정하면 가상 COM 포트가 호스트의 실제 COM 포트에 연결되기를 기다립니다. $False 값을 지정하는 경우 가상 COM 포트는 가상 머신이 시작되는 즉시 호스트의 물리적 COM 포트에 즉시 연결됩니다.

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

출력

VirtualCOMPort

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

참고

VMM 가상 COM 포트 개체가 필요합니다. Get-SCVirtualCOMPort cmdlet을 사용하여 이 개체를 검색할 수 있습니다.