Compartir a través de

Add-SCVPNConnection

  • Referencia
Módulo:
VirtualMachineManager

Agrega una conexión VPN a una red de máquina virtual.

Sintaxis

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

El cmdlet Add-SCVPNConnection agrega una conexión de red privada virtual (VPN) a una red de máquina virtual para establecer un túnel de sitio a sitio desde una puerta de enlace de red administrada de Virtual Machine Manager (VMM) a otro punto de conexión.

Ejemplos

Ejemplo 1: Agrega una conexión 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

El primer comando obtiene una puerta de enlace de red denominada VMGateway01 y, a continuación, la almacena en la variable $VmNetworkGateway.

El segundo comando obtiene una cuenta de ejecución y, a continuación, la almacena en la variable $RunAsAccount. Esta cuenta se usa para agregar la conexión VPN.

El comando final agrega una conexión VPN a la puerta de enlace de red de máquina virtual en $VmNetworkGateway y, a continuación, la almacena en la variable $VpnConnection.

Parámetros

-AuthenticationMethod

Especifica un método de autenticación de red privada virtual (VPN). Los valores válidos son: PSKOnly, MachineCertificates.

Tipo:VPNAuthenticationMethod
Valores aceptados:PSKOnly, MachineCertificates
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-AuthenticationTransformConstants

Especifica una constante de transformación de red privada virtual (VPN). Los valores válidos son:

  • SHA256128
  • MD596
  • SHA196
  • GCMAES128
  • GCMAES192
  • GCMAES256
Tipo:VPNAuthenticationTransformConstants
Valores aceptados:SHA256128, MD596, SHA196, GCMAES128, GCMAES192, GCMAES256, SHA256, None
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Certificate

Especifica un objeto de certificado de seguridad.

Tipo:ClientCertificate
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CipherTransformConstants

Especifica una constante de transformación de cifrado de red privada virtual. Los valores válidos son:

  • DES
  • DES3
  • AES128
  • AES192
  • AES256
  • GCMAES128
  • GCMAES192
  • GCMAES256
Tipo:VPNCipherTransformConstants
Valores aceptados:DES, DES3, AES128, AES192, AES256, GCMAES128, GCMAES192, GCMAES256, None
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica una descripción de la conexión VPN.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DHGroup

Especifica un grupo de Diffie-Hellman (DH) de red privada virtual (VPN). Los valores válidos son:

  • Ninguno
  • Group1
  • Group2
  • Group14
  • ECP256
  • ECP384
  • Group24
Tipo:VPNDHGroup
Valores aceptados:None, Group1, Group2, Group14, ECP256, ECP384, Group24
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EncryptionMethod

Especifica un método de cifrado de red privada virtual (VPN). Los valores válidos son:

  • DES
  • DES3
  • AES128
  • AES192
  • AES256
Tipo:VPNEncryptionMethod
Valores aceptados:DES, DES3, AES128, AES192, AES256, CBCDES, CBCDES3, AES128CBC, AES192CBC, AES256CBC, GCMAES128, GCMAES192, GCMAES256
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GREIPv4Address

Especifica una dirección IPv4 de encapsulación de ruta genérica (GRE).

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GREIPv6Address

Especifica una dirección IPv6 de GRE.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GREKey

Especifica una clave GRE.

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GRETunnel

Indica que este cmdlet usa un túnel GRE.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IntegrityCheckMethod

Especifica un método de comprobación de integridad de red privada virtual (VPN). Los valores válidos son:

  • MD5
  • SHA1
  • SHA256
  • SHA384
Tipo:VPNIntegrityCheckMethod
Valores aceptados:MD5, SHA1, SHA256, SHA384, SHA196
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IPAddresses

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IPSecIdleDisconnectSeconds

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IPSecMainSALifeTimeKiloBytes

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IPSecMainSALifeTimeSeconds

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IPSecQuickSALifeTimeKiloBytes

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IPSecQuickSALifeTimeSeconds

Tipo:UInt32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LocalTrafficSelectors

Tipo:TrafficSelector[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaximumBandwidthInboundKbps

Especifica, en kbps, el ancho de banda de entrada máximo.

Tipo:UInt64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-MaximumBandwidthOutboundKbps

Especifica, en kbps, el ancho de banda de salida máximo.

Tipo:UInt64
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de un objeto VMM.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NextHopNetwork

Especifica un objeto VMNetwork de .

Tipo:VMNetwork
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole. Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PeerIPAddresses

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PFSGroup

Especifica un grupo de confidencialidad directa perfecta (PFS) de una red privada virtual (VPN). Los valores válidos son:

  • Ninguno
  • PFS1
  • PFS2
  • PFS2048
  • ECP256
  • ECP384
  • PFSMM
  • PFS24
Tipo:VPNPFSGroup
Valores aceptados:None, PFS1, PFS2, PFS2048, ECP256, ECP384, PFSMM, PFS24, PFS14
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Protocol

Especifica un protocolo VPN. Los valores aceptables para este parámetro son:

  • IKEv2
  • L2TP
  • PPTP
  • GRE
Tipo:VPNProtocol
Valores aceptados:IKEv2, L2TP, PPTP, GRE, L3, IPSec
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RemoteTrafficSelectors

Tipo:TrafficSelector[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Secret

Especifica una cuenta de ejecución.

Para obtener una cuenta de ejecución, use el cmdlet Get-SCRunAsAccount.

Tipo:RunAsAccount
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TargetIPv4VPNAddress

Especifica una dirección VPN de destino en formato IPv4.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TargetIPv6VPNAddress

Especifica una dirección VPN de destino en formato IPv6.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMNetworkGateway

Especifica un objeto de puerta de enlace de red de máquina virtual.

Para obtener un objeto de VMNetworkGateway, use el cmdlet Get-SCVMNetworkGateway .

Tipo:VMNetworkGateway
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False