Add-SCVPNConnection

Référence

Module:: VirtualMachineManager

Ajoute une connexion VPN à un réseau de machines virtuelles.

Syntaxe

Add-SCVPNConnection
   [-VMMServer <ServerConnection>]
   [-VMNetworkGateway] <VMNetworkGateway>
   [-Name <String>]
   [-Description <String>]
   [-TargetIPv4VPNAddress <String>]
   [-TargetIPv6VPNAddress <String>]
   [-EncryptionMethod <VPNEncryptionMethod>]
   [-IntegrityCheckMethod <VPNIntegrityCheckMethod>]
   [-CipherTransformConstants <VPNCipherTransformConstants>]
   [-AuthenticationTransformConstants <VPNAuthenticationTransformConstants>]
   [-PFSGroup <VPNPFSGroup>]
   [-DHGroup <VPNDHGroup>]
   -Protocol <VPNProtocol>
   [-AuthenticationMethod <VPNAuthenticationMethod>]
   [-Secret <RunAsAccount>]
   [-Certificate <ClientCertificate>]
   [-IPSecMainSALifeTimeSeconds <UInt32>]
   [-IPSecMainSALifeTimeKiloBytes <UInt32>]
   [-IPSecQuickSALifeTimeSeconds <UInt32>]
   [-IPSecQuickSALifeTimeKiloBytes <UInt32>]
   [-IPSecIdleDisconnectSeconds <UInt32>]
   [-LocalTrafficSelectors <TrafficSelector[]>]
   [-RemoteTrafficSelectors <TrafficSelector[]>]
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Add-SCVPNConnection
   [-VMMServer <ServerConnection>]
   [-VMNetworkGateway] <VMNetworkGateway>
   [-Name <String>]
   [-Description <String>]
   [-TargetIPv4VPNAddress <String>]
   [-TargetIPv6VPNAddress <String>]
   -Protocol <VPNProtocol>
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   [-GRETunnel]
   [-GREKey <UInt32>]
   [-GREIPv4Address <String>]
   [-GREIPv6Address <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Add-SCVPNConnection
   [-VMMServer <ServerConnection>]
   [-VMNetworkGateway] <VMNetworkGateway>
   -NextHopNetwork <VMNetwork>
   [-Name <String>]
   [-Description <String>]
   -Protocol <VPNProtocol>
   [-MaximumBandwidthInboundKbps <UInt64>]
   [-MaximumBandwidthOutboundKbps <UInt64>]
   -IPAddresses <String[]>
   -PeerIPAddresses <String[]>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Add-SCVPNConnection ajoute une connexion de réseau privé virtuel (VPN) à un réseau de machines virtuelles pour établir un tunnel de site à site à partir d’une passerelle réseau managée VMM (Virtual Machine Manager) vers un autre point de terminaison.

Exemples

Exemple 1 : Ajoute une connexion VPN

PS C:\> $VmNetworkGateway = Get-SCVMNetworkGateway -Name "VMGateway01"
PS C:\> $RunAsAccount = Get-SCRunAsAccount -ID "972567d5-96ad-472e-9790-831bae5fd69c" 
PS C:\> $VpnConnection = Add-SCVPNConnection -AuthenticationMethod "PSKOnly" -AuthenticationTransformConstants "SHA196" -CipherTransformConstants "AES256" -DHGroup "Group2" -EncryptionMethod "AES256" -IntegrityCheckMethod "SHA1" -PFSGroup "PFS2048" -Protocol "IKEv2" -Name "IPSec" -TargetIPv4VPNAddress "100.100.100.100" -Secret $RunAsAccount -VMNetworkGateway $VmNetworkGateway

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

La deuxième commande obtient un compte d’identification, puis le stocke dans la variable $RunAsAccount. Ce compte est utilisé pour ajouter la connexion VPN.

La commande finale ajoute une connexion VPN à la passerelle de réseau de machine virtuelle dans $VmNetworkGateway, puis la stocke dans la variable $VpnConnection.

Paramètres

-AuthenticationMethod

Spécifie une méthode d’authentification de réseau privé virtuel (VPN). Les valeurs valides sont : PSKOnly, MachineCertificates.

Type:	VPNAuthenticationMethod
Valeurs acceptées:	PSKOnly, MachineCertificates
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-AuthenticationTransformConstants

Spécifie une constante de transformation de réseau privé virtuel (VPN). Les valeurs valides sont les suivantes :

SHA256128
MD596
SHA196
GCMAES128
GCMAES192
GCMAES256

Type:	VPNAuthenticationTransformConstants
Valeurs acceptées:	SHA256128, MD596, SHA196, GCMAES128, GCMAES192, GCMAES256, SHA256, None
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Certificate

Spécifie un objet de certificat de sécurité.

Type:	ClientCertificate
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CipherTransformConstants

Spécifie des constantes de transformation de chiffrement de réseau privé virtuel. Les valeurs valides sont les suivantes :

DES
DES3
AES128
AES192
AES256
GCMAES128
GCMAES192
GCMAES256

Type:	VPNCipherTransformConstants
Valeurs acceptées:	DES, DES3, AES128, AES192, AES256, GCMAES128, GCMAES192, GCMAES256, None
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Description

Spécifie une description de la connexion VPN.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DHGroup

Spécifie un groupe de Diffie-Hellman (DH) de réseau privé virtuel (VPN). Les valeurs valides sont les suivantes :

Aucun
Groupe1
Groupe2
Groupe14
ECP256
ECP384
Groupe24

Type:	VPNDHGroup
Valeurs acceptées:	None, Group1, Group2, Group14, ECP256, ECP384, Group24
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-EncryptionMethod

Spécifie une méthode de chiffrement de réseau privé virtuel (VPN). Les valeurs valides sont les suivantes :

DES
DES3
AES128
AES192
AES256

Type:	VPNEncryptionMethod
Valeurs acceptées:	DES, DES3, AES128, AES192, AES256, CBCDES, CBCDES3, AES128CBC, AES192CBC, AES256CBC, GCMAES128, GCMAES192, GCMAES256
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-GREIPv4Address

Spécifie une adresse IPv4 de routage générique (GRE).

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-GREIPv6Address

Spécifie une adresse GRE IPv6.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-GREKey

Spécifie une clé GRE.

Type:	UInt32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-GRETunnel

Indique que cette applet de commande utilise un tunnel GRE.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-IntegrityCheckMethod

Spécifie une méthode de vérification de l’intégrité du réseau privé virtuel (VPN). Les valeurs valides sont les suivantes :

MD5
SHA1
SHA256
SHA384

Type:	VPNIntegrityCheckMethod
Valeurs acceptées:	MD5, SHA1, SHA256, SHA384, SHA196
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-IPAddresses

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-IPSecIdleDisconnectSeconds

Type:	UInt32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-IPSecMainSALifeTimeKiloBytes

Type:	UInt32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-IPSecMainSALifeTimeSeconds

Type:	UInt32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-IPSecQuickSALifeTimeKiloBytes

Type:	UInt32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-IPSecQuickSALifeTimeSeconds

Type:	UInt32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-JobVariable

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

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-LocalTrafficSelectors

Type:	TrafficSelector[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-MaximumBandwidthInboundKbps

Spécifie, en kbits/s, la bande passante entrante maximale.

Type:	UInt64
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-MaximumBandwidthOutboundKbps

Spécifie, en kbits/s, la bande passante sortante maximale.

Type:	UInt64
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Name

Spécifie le nom d’un objet VMM.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-NextHopNetwork

Spécifie un objet VMNetwork.

Type:	VMNetwork
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-OnBehalfOfUser

Spécifie un nom d’utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PeerIPAddresses

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PFSGroup

Spécifie un groupe PFS (Virtual Private Network) Perfect Forward Secrety (PFS). Les valeurs valides sont les suivantes :

Aucun
PFS1
PFS2
PFS2048
ECP256
ECP384
PFSMM
PFS24

Type:	VPNPFSGroup
Valeurs acceptées:	None, PFS1, PFS2, PFS2048, ECP256, ECP384, PFSMM, PFS24, PFS14
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-PROTipID

Spécifie l’ID de l’info-bulle 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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Protocol

Spécifie un protocole VPN. Les valeurs acceptables pour ce paramètre sont les suivantes :

IKEv2
L2TP
PPTP
GRE

Type:	VPNProtocol
Valeurs acceptées:	IKEv2, L2TP, PPTP, GRE, L3, IPSec
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RemoteTrafficSelectors

Type:	TrafficSelector[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RunAsynchronously

Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Secret

Spécifie un compte d’identification.

Pour obtenir un compte d’identification, utilisez l’applet de commande Get-SCRunAsAccount.

Type:	RunAsAccount
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetIPv4VPNAddress

Spécifie une adresse VPN cible au format IPv4.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-TargetIPv6VPNAddress

Spécifie une adresse VPN cible au format IPv6.

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-VMMServer

Spécifie un objet serveur VMM.

Type:	ServerConnection
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-VMNetworkGateway

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

Pour obtenir un objet VMNetworkGateway, utilisez l’applet de commande Get-SCVMNetworkGateway .

Type:	VMNetworkGateway
Position:	0
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Partager via