Set-SCVirtualNetwork

VMM에서 관리하는 호스트에 구성된 가상 네트워크의 속성을 변경합니다.

Syntax

Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-VMHostNetworkAdapters <HostNetworkAdapter[]>]
   [-Description <String>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-VirtualNetwork] <VirtualNetwork>
   -LogicalSwitch <LogicalSwitch>
   [-Description <String>]
   [-JobGroup <Guid>]
   [-ConvertToLogicalSwitch]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCVirtualNetwork
   [-ClusterVirtualNetwork] <ClusterVirtualNetwork>
   [-Name <String>]
   [-Description <String>]
   [-BoundToVMHost <Boolean>]
   [-HostBoundVLanId <UInt16>]
   [-JobGroup <Guid>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

Set-SCVirtualNetwork cmdlet은 VMM(Virtual Machine Manager)에서 관리하는 호스트에 구성된 가상 네트워크의 속성을 변경합니다.

변경할 수 있는 가상 네트워크 속성은 다음과 같습니다.

  • 모든 호스트. VMM(Hyper-V, VMware ESX 또는 Citrix XenServer 호스트)에서 지원하는 호스트에 배포된 가상 머신에 대해 구성된 가상 네트워크의 경우 이름 또는 설명을 설정하거나 수정할 수 있습니다.

  • Hyper-V 호스트만. 호스트가 Hyper-V 호스트인 경우 가상 머신이 호스트에 바인딩되어 호스트 운영 체제에 액세스할 수 있는지 여부도 구성할 수 있으며 호스트에서 VLAN(가상 로컬 영역 네트워크)에 대한 숫자 식별자를 지정할 수도 있습니다.

예제

예제 1: 호스트에서 가상 네트워크 바인딩 해제

PS C:\> $VMHost = Get-SCVMHost -ComputerName "VMHost01.Contoso.com" 
PS C:\> $VirtualNetwork = Get-SCVirtualNetwork -VMHost $VMHost -Name "InternalVNet01"
PS C:\> Set-SCVirtualNetwork -VirtualNetwork $VirtualNetwork -Name "UnboundVNet01" -BoundToVMHost $False

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

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

마지막 명령은 가상 네트워크의 이름을 UnboundVNet01로 바꾸고 VMHostBound 를 $False 설정합니다. 그러면 호스트에서 가상 네트워크의 바인딩이 해제되어 해당 가상 네트워크에 연결된 가상 컴퓨터가 이 네트워크를 통해 호스트에 액세스하지 못하게 됩니다.

매개 변수

-BoundToVMHost

가상 네트워크가 호스트에 바인딩되는지 여부를 나타냅니다. 호스트에 가상 네트워크를 바인딩하면 호스트에 대한 네트워크 통신이 가능합니다.

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

-ClusterVirtualNetwork

클러스터 가상 네트워크 개체를 지정합니다.

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

-ConvertToLogicalSwitch

이 cmdlet은 가상 네트워크를 논리 스위치로 변환한다는 것을 나타냅니다.

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

-HostBoundVLanId

지정된 가상 네트워크에 대한 호스트에 대해 만들어진 가상 네트워크 어댑터에 VLAN을 할당합니다.

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

-LogicalSwitch

논리 스위치 개체를 지정합니다.

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

-Name

VMM 개체의 이름을 지정합니다.

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:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHostNetworkAdapters

호스트에서 하나 이상의 실제 네트워크 어댑터 개체 배열을 지정합니다. 해당 호스트에 배포되는 가상 컴퓨터를 이 배열에 연결할 수 있습니다.

예제 형식: -VMHostNetworkAdapters $VMHostNICs

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

출력

VirtualNetwork

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