Delen via

Add-SCVMNetworkGateway

  • Referentie
Module:
VirtualMachineManager

Hiermee voegt u een virtuele-machinenetwerkgateway toe aan VMM.

Syntaxis

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

De cmdlet Add-SCVMNetworkGateway voegt een virtuele-machinenetwerkgateway toe aan Virtual Machine Manager (VMM).

Voorbeelden

Voorbeeld 1: Een virtuele-machinenetwerkgateway maken

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"

Met de eerste opdracht wordt een netwerkgateway met de naam ContosoNetworkGateway opgeslagen en vervolgens opgeslagen in de variabele $ContosoNetworkGateway.

Met de tweede opdracht maakt u een virtuele-machinenetwerkgateway voor de gateway in $ContosoNetworkGateway.

Voorbeeld 2: Een virtuele-machinenetwerkgateway maken (IPv6)

Notitie

Dit voorbeeld is van toepassing op VMM 2019 UR2 en hoger.

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"

Met de eerste opdracht wordt een netwerkgateway met de naam ContosoNetworkGateway opgeslagen en vervolgens opgeslagen in de variabele $ContosoNetworkGateway.

Met de tweede opdracht maakt u een virtuele-machinenetwerkgateway voor de gateway in $ContosoNetworkGateway.

Parameters

-AutonomousSystemNumber

Hiermee geeft u een autonoom systeemnummer (ASN) op.

Type:UInt32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Hiermee geeft u een beschrijving voor de virtuele-machinenetwerkgateway.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-EnableBGP

Geeft aan of Border Gateway Protocol (BGP) is ingeschakeld.

Type:Boolean
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-FabricRole

Hiermee geeft u een infrastructuurrol op.

Type:FabricRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NetworkGateway

Hiermee geeft u een netwerkgatewayobject.

Als u een netwerkgatewayobject wilt verkrijgen, gebruikt u de cmdlet Get-SCNetworkGateway.

Type:NetworkServiceBase
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RequiresNAT

Geeft aan dat voor de verbinding netwerkadresomzetting (NAT) is vereist.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RequiresVPN

Geeft aan dat een virtueel particulier netwerk (VPN) vereist is.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RoutingIPSubnet

Hiermee geeft u een routerings-IP-subnet voor een virtuele-machinenetwerkgateway.

Notitie

Vanaf 2019 UR2 en hoger kunnen IPV4- en IPV6-adressen gescheiden door ';' worden doorgegeven aan deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMNetwork

Hiermee geeft u een netwerkobject van een virtuele machine.

Als u een netwerkobject voor een virtuele machine wilt ophalen, gebruikt u de cmdlet Get-SCVMNetwork.

Type:VMNetwork
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False