다음을 통해 공유


Set-SCVMHostNetworkAdapter

VMM에서 관리하는 호스트의 실제 네트워크 어댑터에 대한 네트워크 관련 속성을 변경합니다.

Syntax

Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanMode <VlanMode>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-SubnetVLan <SubnetVLan[]>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-AddOrSetLogicalNetwork <LogicalNetwork>]
   [-RemoveLogicalNetwork <LogicalNetwork>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVMHostNetworkAdapter
   [-VMHostNetworkAdapter] <HostNetworkAdapter>
   [-Description <String>]
   [-VLanEnabled <Boolean>]
   [-VLanMode <VlanMode>]
   [-VLanID <UInt16>]
   [-VLanTrunkID <UInt16[]>]
   [-AvailableForPlacement <Boolean>]
   [-UsedForManagement <Boolean>]
   [-RemoveUnassignedVLan <UInt16[]>]
   [-EnableNetworkVirtualization <Boolean>]
   [-UplinkPortProfileSet <UplinkPortProfileSet>]
   [-RemoveUplinkPortProfileSet]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Set-SCVMHostNetworkAdapter cmdlet은 VMM(Virtual Machine Manager)에서 관리하는 호스트의 실제 네트워크 어댑터에 대한 네트워크 관련 속성을 변경합니다.

이 cmdlet을 사용하면 다음과 같은 속성을 변경할 수 있습니다.

  • VLAN 설정: VLAN 매개 변수를 사용하여 단일 VLAN 또는 여러 VLAN을 만들거나 수정할 수 있습니다. VLAN 설정을 지정하는 방법에 대한 일러스트레이션은 예제를 참조하세요.

VLAN에 대한 자세한 내용과 VLAN 설정을 보여 주는 추가 예제를 보려면 다음을 입력합니다 Get-Help Add-SCVMHostNetworkAdapter -Detailed.

예제

예제 1: 호스트 네트워크 어댑터에 새 가상 네트워크를 만들고 가상 네트워크에 대한 VLAN ID 지정

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost02.Contoso.com"
PS C:\> $HostAdapter = Get-SCVMHostNetworkAdapter -VMHost $VMHost |  where {$_.Name -like "Intel(R) PRO/1000*" }
PS C:\> New-SCVirtualNetwork -Name "VirtualNetwork01" -VMHost $VMHost -VMHostNetworkAdapter $HostAdapter
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $HostAdapter -VLanEnabled $True -VLanMode "Access" -VLANID 35

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

두 번째 명령은 VMHost02에서 "Intel(R) PRO/1000"으로 시작하는 이름의 호스트 네트워크 어댑터 개체를 가져오고 개체를 $HostAdapter 변수에 저장합니다.

세 번째 명령은 $HostAdapter 저장된 호스트 어댑터에 바인딩된 VMHost02에 VirtualNetwork01이라는 가상 네트워크를 만듭니다.

마지막 명령은 VLAN을 사용하도록 설정하고, 모드를 Access로 설정하고(단일 VLAN 내에서 내부적으로 트래픽을 라우팅) 네트워크 어댑터에 35의 VLANID를 할당합니다.

참고: 이 예제에서는 호스트가 이미 VLAN에 연결되어 있거나, 그렇지 않은 경우 호스트에 두 개의 네트워크 어댑터가 있다고 가정합니다. 호스트에 단일 네트워크 어댑터가 있는 경우 VMM 서버에서 사용할 수 없는 VLAN에 어댑터를 할당하면 VMM에서 호스트를 관리할 수 없습니다.

예제 2: 트렁크 모드로 구성된 호스트 네트워크 어댑터에 VLan 태그 추가

PS C:\> $VMHost = Get-SCVMHost -Computername "VMHost03.Contoso.com"
PS C:\> $VMHostNIC = Get-SCVMHostNetworkAdapter -VMHost $VMHost -Name "Adapter #3"
PS C:\> $NewVlanTags = $VMHostNIC.VlanTags + @(177,355,1012)
PS C:\> Set-SCVMHostNetworkAdapter -VMHostNetworkAdapter $VMHostNIC -VLANEnabled $TRUE -VLanMode "Trunk" -VLanTrunkID $NewVLanTags

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

두 번째 명령은 어댑터 이름을 지정하여 호스트 네트워크 어댑터 개체를 가져오고 개체를 $VMHostNIC 변수에 저장합니다.

세 번째 명령은 호스트 네트워크 어댑터 개체($VMHostNIC.VlanTags)의 VlanTags 속성을 사용하고 새 태그 배열을 연결합니다. 업데이트된 배열은 exisiting VlanTags를 유지하고 나열된 태그를 배열에 추가합니다. 연결 결과는 $NewVlanTags 저장됩니다.

마지막 명령은 새 VLAN 태그 목록을 Set-VMHostNetworkAdapterVLANTrunkID 매개 변수에 전달합니다. VLANTrunkID 매개 변수를 사용하여 VLAN 트렁크 숫자 식별자 목록을 수정할 때마다 VLANMode 매개 변수는 "트렁크" 값을 지정해야 합니다.

매개 변수

-AddOrSetLogicalNetwork

추가되거나 업데이트될 논리 네트워크를 지정합니다.

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

-AvailableForPlacement

VMM 배치 프로세스에서 이 호스트 또는 호스트의 이 볼륨을 가상 머신을 배포할 수 있는 위치로 사용할 수 있는지 여부를 나타냅니다. 이 매개 변수가 $False 설정된 경우 이 호스트 또는 볼륨에 가상 머신을 배포하도록 선택할 수 있습니다. 기본값은 $True. 이 매개 변수는 VMware ESX 호스트에는 적용되지 않습니다.

이 매개 변수를 네트워크 어댑터와 함께 사용하는 경우 $False 설정하면 호스트가 가상 머신 연결에 적합한지 확인하기 위해 이 네트워크 어댑터에 구성된 논리 네트워크를 고려하지 않습니다.

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

-Description

지정된 개체에 대한 설명을 지정합니다.

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

-EnableNetworkVirtualization

네트워크 가상화를 사용할 수 있는지 여부를 지정합니다. 기본값은 $False.

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

-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

-RemoveLogicalNetwork

제거할 논리 네트워크를 지정합니다.

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

-RemoveUnassignedVLan

지정된 VLAN이 논리 네트워크에 연결되지 않은 경우 어댑터의 VLAN 트렁크에서 제거되도록 지정합니다.

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

-RemoveUplinkPortProfileSet

호스트 네트워크 어댑터에서 업링크 포트 프로필 집합을 제거합니다.

Type:SwitchParameter
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

-SubnetVLan

하나 이상의 IP 서브넷 및 VLAN 집합을 지정합니다.

SubnetVLan을 만드는 방법에 대한 자세한 내용은 다음을 입력합니다 Get-Help New-SCSubNetVLan.

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

-UplinkPortProfileSet

업링크 포트 프로필 집합 개체를 지정합니다.

업링크 포트 프로필 집합 개체를 가져오려면 Get-SCUplinkPortProfileSet cmdlet을 사용합니다.

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

-UsedForManagement

개체가 호스트를 관리하는 데 사용되는지 여부를 나타냅니다.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:Boolean
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 개체를 반환합니다.