Add-SCVMNetworkGateway

VMM에 가상 머신 네트워크 게이트웨이를 추가합니다.

Syntax

Add-SCVMNetworkGateway
   [-VMMServer <ServerConnection>]
   -VMNetwork <VMNetwork>
   [-RequiresVPN]
   [-RequiresNAT]
   [-EnableBGP <Boolean>]
   [-AutonomousSystemNumber <UInt32>]
   -Name <String>
   [-Description <String>]
   [-RoutingIPSubnet <String>]
   [-FabricRole <FabricRole>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Add-SCVMNetworkGateway
   [-VMMServer <ServerConnection>]
   -VMNetwork <VMNetwork>
   -NetworkGateway <NetworkServiceBase>
   [-EnableBGP <Boolean>]
   [-AutonomousSystemNumber <UInt32>]
   -Name <String>
   [-Description <String>]
   [-RoutingIPSubnet <String>]
   [-FabricRole <FabricRole>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

Add-SCVMNetworkGateway cmdlet은 가상 머신 네트워크 게이트웨이를 VMM(Virtual Machine Manager)에 추가합니다.

예제

예제 1: 가상 머신 네트워크 게이트웨이 만들기

PS C:\> $ContosoNetworkGateway = Get-SCNetworkGateway -Name "ContosoNetworkGateway"
PS C:\> $VmNetworkGateway = Add-SCVMNetworkGateway -Name "VMNetworkGateway" -EnableBGP $True -NetworkGateway $ContosoNetworkGateway -VMNetwork $VmNetwork -AutonomousSystemNumber "1000" -RoutingIPSubnet "10.251.251.0/29"

첫 번째 명령은 ContosoNetworkGateway라는 네트워크 게이트웨이를 가져오고 $ContosoNetworkGateway 변수에 저장합니다.

두 번째 명령은 $ContosoNetworkGateway 게이트웨이에 대한 가상 머신 네트워크 게이트웨이를 만듭니다.

예제 2: 가상 머신 네트워크 게이트웨이 만들기(IPv6)

참고

이 예제는 VMM 2019 UR2 이상에서 적용할 수 있습니다.

PS C:\> $ContosoNetworkGateway = Get-SCNetworkGateway -Name "ContosoNetworkGateway"
PS C:\> $VmNetworkGateway = Add-SCVMNetworkGateway -Name "VMNetworkGateway" -EnableBGP $True -NetworkGateway $ContosoNetworkGateway -VMNetwork $VmNetwork -AutonomousSystemNumber "1000" -RoutingIPSubnet "10.251.251.0;FD4A:293D:184F:382C::/64"

첫 번째 명령은 ContosoNetworkGateway라는 네트워크 게이트웨이를 가져오고 $ContosoNetworkGateway 변수에 저장합니다.

두 번째 명령은 $ContosoNetworkGateway 게이트웨이에 대한 가상 머신 네트워크 게이트웨이를 만듭니다.

매개 변수

-AutonomousSystemNumber

ASN(자치 시스템 번호)을 지정합니다.

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

-EnableBGP

BGP(Border Gateway Protocol)를 사용할 수 있는지 여부를 나타냅니다.

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

-FabricRole

패브릭 역할을 지정합니다.

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

-Name

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

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

-NetworkGateway

네트워크 게이트웨이 개체를 지정합니다.

네트워크 게이트웨이 개체를 가져오려면 Get-SCNetworkGateway cmdlet을 사용합니다.

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

-OnBehalfOfUser

사용자 이름을 지정합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자를 대신하여 작동합니다.

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

-OnBehalfOfUserRole

사용자 역할을 지정합니다. 사용자 역할을 가져오려면 Get-SCUserRole cmdlet을 사용합니다. 이 cmdlet은 이 매개 변수가 지정하는 사용자 역할을 대신하여 작동합니다.

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

-RequiresNAT

연결에 NAT(네트워크 주소 변환)가 필요했음을 나타냅니다.

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

-RequiresVPN

VPN(가상 사설망)이 필요했음을 나타냅니다.

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

-RoutingIPSubnet

가상 머신 네트워크 게이트웨이에 대한 라우팅 IP 서브넷을 지정합니다.

참고

2019 UR2 이상에서는 ';'로 구분된 IPV4 및 IPV6 주소를 이 매개 변수에 전달할 수 있습니다.

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

-VMMServer

VMM 서버 개체를 지정합니다.

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

-VMNetwork

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

가상 머신 네트워크 개체를 얻으려면 Get-SCVMNetwork cmdlet을 사용합니다.

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