Partager via


Add-SCVMNetworkGateway

Ajoute une passerelle réseau de machine virtuelle à 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

L’applet de commande Add-SCVMNetworkGateway ajoute une passerelle réseau de machine virtuelle à Virtual Machine Manager (VMM).

Exemples

Exemple 1 : Créer une passerelle réseau de machine virtuelle

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"

La première commande obtient une passerelle réseau nommée ContosoNetworkGateway, puis la stocke dans la variable $ContosoNetworkGateway.

La deuxième commande crée une passerelle réseau de machine virtuelle pour la passerelle dans $ContosoNetworkGateway.

Exemple 2 : Créer une passerelle réseau de machine virtuelle (IPv6)

Notes

Cet exemple s’applique à VMM 2019 UR2 et versions ultérieures.

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"

La première commande obtient une passerelle réseau nommée ContosoNetworkGateway, puis la stocke dans la variable $ContosoNetworkGateway.

La deuxième commande crée une passerelle réseau de machine virtuelle pour la passerelle dans $ContosoNetworkGateway.

Paramètres

-AutonomousSystemNumber

Spécifie un numéro de système autonome (ASN).

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

-Description

Spécifie une description de la passerelle réseau de machine virtuelle.

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

-EnableBGP

Indique si le protocole BGP (Border Gateway Protocol) est activé.

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

-FabricRole

Spécifie un rôle d’infrastructure.

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

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

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

-Name

Spécifie le nom d’un objet VMM.

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

-NetworkGateway

Spécifie un objet de passerelle réseau.

Pour obtenir un objet de passerelle réseau, utilisez l’applet de commande Get-SCNetworkGateway .

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

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne au nom de l’utilisateur spécifié par ce paramètre.

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

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

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

-PROTipID

Spécifie l’ID du conseil d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

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

-RequiresNAT

Indique que la connexion nécessite la traduction d’adresses réseau (NAT).

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

-RequiresVPN

Indique qu’un réseau privé virtuel (VPN) est requis.

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

-RoutingIPSubnet

Spécifie un sous-réseau IP de routage pour une passerelle réseau de machine virtuelle.

Notes

À partir de 2019 UR2 et versions ultérieures, les adresses IPV4 et IPV6 séparées par « ; » peuvent être passées à ce paramètre.

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

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

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

-VMMServer

Spécifie un objet serveur VMM.

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

-VMNetwork

Spécifie un objet réseau de machine virtuelle.

Pour obtenir un objet réseau de machine virtuelle, utilisez l’applet de commande Get-SCVMNetwork .

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