Set-SCVMHostNetworkAdapter
VMM에서 관리하는 호스트의 실제 네트워크 어댑터에 대한 네트워크 관련 속성을 변경합니다.
구문
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 속성을 사용하고 새 태그 배열을 연결합니다. 업데이트된 배열은 확장되는 VlanTags를 유지하고 나열된 태그를 배열에 추가합니다. 연결 결과는 $NewVlanTags 저장됩니다.
마지막 명령은 새 VLAN 태그 목록을 Set-VMHostNetworkAdapterVLANTrunkID 매개 변수에 전달합니다. VLANMode 매개 변수는 VLANTrunkID 매개 변수를 사용하여 VLAN 트렁크 숫자 식별자 목록을 수정할 때마다 "트렁크" 값을 지정해야 합니다.
매개 변수
-AddOrSetLogicalNetwork
추가하거나 업데이트할 논리 네트워크를 지정합니다.
형식: | LogicalNetwork |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-AvailableForPlacement
VMM 배치 프로세스에서 이 호스트 또는 호스트의 이 볼륨을 가상 머신을 배포할 수 있는 가능한 위치로 간주하는지 여부를 나타냅니다. 이 매개 변수가 $False 설정된 경우 이 호스트 또는 볼륨에 가상 머신을 배포하도록 선택할 수 있습니다. 기본값은 $True. 이 매개 변수는 VMware ESX 호스트에는 적용되지 않습니다.
이 매개 변수를 네트워크 어댑터와 함께 사용하는 경우 $False 설정하면 배치는 호스트가 가상 머신 연결에 적합한지 확인하기 위해 이 네트워크 어댑터에 구성된 논리 네트워크를 고려하지 않습니다.
형식: | Boolean |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Description
지정된 개체에 대한 설명을 표시합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-EnableNetworkVirtualization
네트워크 가상화를 사용할 수 있는지 여부를 지정합니다. 기본값은 $False.
형식: | Boolean |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-JobGroup
동일한 작업 그룹 식별자를 포함하는 최종 명령이 실행되기 직전에 집합으로 실행되는 일련의 명령에 대한 식별자를 지정합니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-JobVariable
작업 진행률이 추적되고 이 매개 변수로 명명된 변수에 저장되도록 지정합니다.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-PROTipID
이 작업을 트리거한 PRO 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 PRO 팁을 감사할 수 있습니다.
형식: | Guid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RemoveLogicalNetwork
제거할 논리 네트워크를 지정합니다.
형식: | LogicalNetwork |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RemoveUnassignedVLan
지정된 VLAN이 논리 네트워크와 연결되지 않은 경우 어댑터의 VLAN 트렁크에서 제거되도록 지정합니다.
형식: | UInt16[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RemoveUplinkPortProfileSet
호스트 네트워크 어댑터에서 업링크 포트 프로필 집합을 제거합니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-RunAsynchronously
컨트롤이 명령 셸로 즉시 반환되도록 작업이 비동기적으로 실행됨을 나타냅니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-SubnetVLan
하나 이상의 IP 서브넷 및 VLAN 집합을 지정합니다.
SubnetVLan을 만드는 방법에 대한 자세한 내용은 Get-Help New-SCSubNetVLan
입력합니다.
형식: | SubnetVLan[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-UplinkPortProfileSet
업링크 포트 프로필 집합 개체를 지정합니다.
업링크 포트 프로필 집합 개체를 가져오려면 Get-SCUplinkPortProfileSet cmdlet을 사용합니다.
형식: | UplinkPortProfileSet |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-UsedForManagement
개체가 호스트를 관리하는 데 사용되는지 여부를 나타냅니다.
형식: | Boolean |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VLanEnabled
Hyper-V 또는 Citrix XenServer 호스트에서 가상 머신에서 사용할 VLAN(가상 LAN)을 사용하도록 설정합니다.
- 단일 VLAN의 예제 형식:
-VLANEnabled -VLANMode "Access" -VLANID 35
- 여러 VLAN의 예제 형식:
-VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
형식: | Boolean |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VLanID
1-4094 범위의 숫자 식별자를 가상 머신의 가상 네트워크 어댑터 또는 가상 머신 호스트의 실제 네트워크 어댑터에 할당합니다.
Hyper-V, VMware ESX 또는 Citrix XenServer 호스트에서 VLanID를 구성합니다.
- VLan 모드가 Access인 경우 외부에 바인딩된 실제 네트워크 어댑터에서
가상 머신의 가상 네트워크 어댑터에서 VLanID를 구성합니다.
- 호스트의 실제 네트워크 어댑터에 바인딩되거나
- 호스트의 내부 가상 네트워크에 바인딩됩니다.
예제 형식: -VLanEnabled -VLanMode "Access" -VLANID 35
형식: | UInt16 |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VLanMode
가상 머신 호스트의 VLAN(가상 LAN)이 단일 VLAN(액세스 모드) 또는 여러 VLAN(트렁크 모드)에서 트래픽을 지원하는지 여부를 지정합니다. 유효한 값은 Access, 트렁크입니다.
형식: | VlanMode |
허용되는 값: | Access, Trunk, Invalid |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VLanTrunkID
1-4094 범위의 숫자 식별자 목록을 Hyper-V 호스트의 실제 네트워크 어댑터에 할당합니다.
예제 형식: -VLANEnabled -VLANMode "Trunk" -VLANTrunkID 1,2,100,200,1124
형식: | UInt16[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-VMHostNetworkAdapter
호스트에 배포된 가상 머신이 연결할 수 있는 호스트의 실제 네트워크 어댑터 개체를 지정합니다.
예제 형식: -VMHostNetworkAdapter $VMHostNIC
형식: | HostNetworkAdapter |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | False |
출력
VMHostNetworkAdapter
이 cmdlet은 VMHostNetworkAdapter 개체를 반환합니다.