Add-SCVMNetworkGateway

Referenz

Modul:: VirtualMachineManager

Fügt ein Netzwerkgateway für virtuelle Computer zu VMM hinzu.

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>]

Beschreibung

Das Add-SCVMNetworkGateway-Cmdlet fügt dem Virtual Machine Manager (VMM) ein Netzwerkgateway für virtuelle Computer hinzu.

Beispiele

Beispiel 1: Erstellen eines Virtuellen Computernetzwerkgateways

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"

Der erste Befehl ruft ein Netzwerkgateway namens ContosoNetworkGateway ab und speichert es dann in der $ContosoNetworkGateway Variablen.

Der zweite Befehl erstellt ein Netzwerkgateway für virtuelle Computer für das Gateway in $ContosoNetworkGateway.

Beispiel 2: Erstellen eines Virtuellen Computernetzwerkgateways (IPv6)

Hinweis

Dieses Beispiel gilt für VMM 2019 UR2 und höher.

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"

Der erste Befehl ruft ein Netzwerkgateway namens ContosoNetworkGateway ab und speichert es dann in der $ContosoNetworkGateway Variablen.

Der zweite Befehl erstellt ein Netzwerkgateway für virtuelle Computer für das Gateway in $ContosoNetworkGateway.

Parameter

-AutonomousSystemNumber

Gibt eine autonome Systemnummer (ASN) an.

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

-Description

Gibt eine Beschreibung für das Netzwerkgateway des virtuellen Computers an.

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

-EnableBGP

Gibt an, ob das Border Gateway Protocol (BGP) aktiviert ist.

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

-FabricRole

Gibt eine Fabric-Rolle an.

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

-JobVariable

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-NetworkGateway

Gibt ein Netzwerkgatewayobjekt an.

Um ein Netzwerkgatewayobjekt abzurufen, verwenden Sie das Cmdlet Get-SCNetworkGateway .

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-PROTipID

Gibt die ID des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-RequiresNAT

Gibt an, dass für die Verbindung die Netzwerkadressenübersetzung (NAT) erforderlich ist.

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

-RequiresVPN

Gibt an, dass ein virtuelles privates Netzwerk (VPN) erforderlich ist.

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

-RoutingIPSubnet

Gibt ein Routing-IP-Subnetz für ein virtuelles Computernetzwerkgateway an.