Add-SCVMHostNetworkAdapter

VMM에서 관리하는 호스트의 실제 네트워크 어댑터를 가상 네트워크에 추가합니다.

Syntax

Add-SCVMHostNetworkAdapter
   -VirtualNetwork <VirtualNetwork>
   [-VLanEnabled]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Add-SCVMHostNetworkAdapter cmdlet은 VMM(Virtual Machine Manager)에서 관리하는 호스트의 실제 네트워크 어댑터(네트워크 인터페이스 카드 또는 NIC라고도 함)를 가상 네트워크에 추가합니다. 해당 호스트의 각 가상 머신은 가상 네트워크 어댑터를 통해 해당 가상 네트워크에 연결할 수도 있습니다.

호스트에 구성된 가상 네트워크에서 호스트에 배포된 가상 컴퓨터의 여러 가상 네트워크 어댑터로 연결할 수 있습니다.

System Center 2019 이상용 VMM에는 호스트에서 하나 이상의 V LAN(가상 로컬 영역 네트워크)을 구성하기 위한 가상 네트워킹 지원이 포함되어 있습니다. Add-SCVMHostNetworkAdapter cmdlet 또는 Set-SCVMHostNetworkAdapter cmdlet을 사용하여 호스트에서 단일 VLAN 또는 여러 VLAN을 구성할 수 있습니다. 가상 머신에서 해당 VLAN 설정을 구성하려면 New-SCVirtualNetworkAdapter cmdlet 또는 Set-SCVirtualNetworkAdapter cmdlet을 사용합니다.

각 VLAN 유형에 대한 자세한 내용을 보려면 이 cmdlet의 예를 참조하십시오.

예제

예제 1: 가상 네트워크에 실제 호스트 네트워크 어댑터 추가

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork01"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter01"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter

첫 번째 명령은 VMHost01이라는 호스트 개체를 가져오고 개체를 $VMHost 변수에 저장합니다.

두 번째 명령은 VMHost01에서 ExternalVirtualNetwork01이라는 가상 네트워크 개체를 가져오고 개체를 $VirtualNetwork 변수에 저장합니다.

세 번째 명령은 VMHost01에서 HostAdapter01이라는 실제 네트워크 어댑터 개체를 가져오고 개체를 $VMHostNetworkAdapter 변수에 저장합니다.

마지막 명령은 ExternalVirtualNetwork01에 HostAdapter01을 추가합니다.

참고: 가상 네트워크당 하나의 실제 호스트 어댑터만 추가할 수 있습니다. 따라서 어댑터가 지정된 가상 네트워크와 이미 연결되어 있으면 마지막 명령이 실패합니다. 가상 네트워크에 새 어댑터를 추가하려면 먼저 기존 호스트 어댑터를 제거해야 합니다.

예제 2: "트렁크" 모드를 사용하는 VLAN에 물리적 호스트 네트워크 어댑터 추가

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost02"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalNetwork02"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter02"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

첫 번째 명령은 VMHost02라는 호스트 개체를 가져오고 개체를 $VMHost 변수에 저장합니다.

두 번째 명령은 VMHost02에서 ExternalNetwork02라는 가상 네트워크 개체를 가져오고 개체를 $VirtualNetwork 변수에 저장합니다.

세 번째 명령은 VMHost02에서 HostAdapter02라는 네트워크 어댑터 개체를 가져오고 어댑터 개체를 $VMHostNetworkAdapter 변수에 저장합니다.

마지막 명령은 가상 네트워크 ExternalNetwork02에 HostAdapter02를 추가하고 802.1Q 태그가 지정된 VLAN 1, 2, 100, 200 및 1124를 사용하여 ExternalNetwork02에서 외부 네트워킹 디바이스로 액세스할 수 있도록 합니다.

참고: 가상 네트워크당 하나의 호스트 어댑터를 추가할 수 있으므로 어댑터가 지정된 가상 네트워크와 이미 연결되어 있으면 마지막 명령이 실패합니다.

예제 3: "액세스" 모드를 사용하는 VLAN에 물리적 호스트 네트워크 어댑터 추가

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost03.Contoso.com"
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "ExternalVirtualNetwork03"
PS C:\> $VMHostNetworkAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "HostAdapter03"
PS C:\> Add-SCVMHostNetworkAdapter -VirtualNetwork $VirtualNetwork -VMHostNetworkAdapter $VMHostNetworkAdapter -VLanEnabled -VLanMode "Access" -VLanID 22

첫 번째 명령은 VMHost03이라는 호스트 개체를 가져오고 개체를 $VMHost 변수에 저장합니다.

두 번째 명령은 VMHost03에서 ExternalNetwork03이라는 가상 네트워크 개체를 가져오고 개체를 $VirtualNetwork 변수에 저장합니다.

세 번째 명령은 VMHost03에서 HostAdapter03이라는 네트워크 어댑터 개체를 가져오고 어댑터 개체를 $VMHostNetworkAdapter 변수에 저장합니다.

마지막 명령은 가상 네트워크 ExternalNetwork03에 HostAdapter03을 추가하고 ExternalNetwork03에 대한 액세스를 VLANID 22로 제한합니다.

참고: 가상 네트워크당 하나의 호스트 어댑터를 추가할 수 있으므로 어댑터가 지정된 가상 네트워크와 이미 연결되어 있으면 마지막 명령이 실패합니다.

주의: 이 예제에서는 호스트가 이미 VLAN에 연결되어 있다고 가정하거나, 그렇지 않은 경우 호스트에 두 개의 네트워크 어댑터가 있는지 확인합니다. 호스트에 단일 네트워크 어댑터가 있는 경우 VMM 서버에서 사용할 수 없는 VLAN에 어댑터를 할당하면 VMM에서 호스트를 관리할 수 없습니다. 서버에 Microsoft Loopback Adapter를 처음 설치하는 경우 네트워크 어댑터가 하나뿐인 호스트에 대해 이 예의 단계를 수행할 수 있습니다.

매개 변수

-JobGroup

동일한 작업 그룹 식별자를 포함하는 마지막 명령이 실행되기 직전에 하나의 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.

Type:Guid
Position:Named
Default value:None
Required:False
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

-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

-VirtualNetwork

가상 네트워크 개체를 지정합니다.

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

-VLanEnabled

Hyper-V 또는 Citrix XenServer 호스트의 가상 머신에서 사용할 VLAN(가상 LAN)을 사용하도록 설정합니다.

단일 VLAN에 대한 예제 형식: -VLANEnabled -VLANMode "Access" -VLANID 35 여러 VLAN에 대한 예제 형식: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

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

-VLanID

1-4094 범위의 숫자 식별자를 가상 머신의 가상 네트워크 어댑터 또는 가상 머신 호스트의 실제 네트워크 어댑터에 할당합니다.

Hyper-V, VMware ESX 또는 Citrix XenServer 호스트에서 VLanID를 구성합니다.

-- VLan 모드가 Access인 경우 외부에 바인딩된 실제 네트워크 어댑터에서

가상 머신의 가상 네트워크 어댑터에서 VLanID를 구성합니다.

  • 호스트의 실제 네트워크 어댑터에 바인딩되거나
  • 호스트의 내부 가상 네트워크에 바인딩됩니다.

예제 형식: -VLanEnabled``-VLanMode "Access" -VLANID 35

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

-VLanMode

가상 머신 호스트의 VLAN(가상 LAN)이 단일 VLAN(액세스 모드) 또는 여러 VLAN(트렁크 모드)에서 트래픽을 지원하는지 여부를 지정합니다. 유효한 값은 Access, Trunk입니다.

Type:VlanMode
Accepted values:Access, Trunk, Invalid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VLanTrunkID

1에서 4094 사이의 숫자 식별자 목록을 Hyper-V 호스트의 실제 네트워크 어댑터에 할당합니다.

예제 형식: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124

Type:UInt16[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMHostNetworkAdapter

해당 호스트에 배포된 가상 머신이 연결할 수 있는 호스트의 실제 네트워크 어댑터 개체를 지정합니다.

예제 형식: -VMHostNetworkAdapter $VMHostNIC

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

출력

VMHostNetworkAdapter

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