Set-AzureRmVirtualNetworkGateway

Módulo:

AzureRM.Network

Actualiza una puerta de enlace de red virtual.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Set-AzureRmVirtualNetworkGateway
   -VirtualNetworkGateway <PSVirtualNetworkGateway>
   [-GatewaySku <String>]
   [-GatewayDefaultSite <PSLocalNetworkGateway>]
   [-VpnClientAddressPool <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientProtocol <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientRootCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRootCertificate]>]
   [-VpnClientRevokedCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate]>]
   [-VpnClientIpsecPolicy <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSIpsecPolicy]>]
   [-Asn <UInt32>]
   [-PeerWeight <Int32>]
   [-EnableActiveActiveFeature]
   [-DisableActiveActiveFeature]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-AzureRmVirtualNetworkGateway
   -VirtualNetworkGateway <PSVirtualNetworkGateway>
   [-GatewaySku <String>]
   [-GatewayDefaultSite <PSLocalNetworkGateway>]
   [-VpnClientAddressPool <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientProtocol <System.Collections.Generic.List`1[System.String]>]
   [-VpnClientRootCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRootCertificate]>]
   [-VpnClientRevokedCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate]>]
   [-VpnClientIpsecPolicy <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSIpsecPolicy]>]
   [-Asn <UInt32>]
   [-PeerWeight <Int32>]
   [-EnableActiveActiveFeature]
   [-DisableActiveActiveFeature]
   -RadiusServerAddress <String>
   -RadiusServerSecret <SecureString>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-AzureRmVirtualNetworkGateway actualiza una puerta de enlace de red virtual.

Ejemplos

Ejemplo 1: Establecimiento del estado objetivo de una puerta de enlace de red virtual

PS C:\>$Gateway = Get-AzureRmVirtualNetworkGateway -ResourceGroupName "ResourceGroup001" -Name "Gateway001"
PS C:\> Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $Gateway -Asn 1337

El primer comando obtiene una puerta de enlace de red virtual denominada Gateway01 que pertenece al grupo de recursos ResourceGroup001 y la almacena en la variable denominada $Gateway El segundo comando establece el estado objetivo de la puerta de enlace de red virtual almacenada en la variable $Gateway. El comando también establece el ASN en 1337.

Ejemplo 2: Establecimiento del estado objetivo de una puerta de enlace de red virtual

PS C:\>$Gateway = Get-AzureRmVirtualNetworkGateway -ResourceGroupName "ResourceGroup001" -Name "Gateway001"
PS C:\> $vpnclientipsecpolicy = New-AzureRmVpnClientIpsecPolicy -IpsecEncryption AES256 -IpsecIntegrity SHA256 -SALifeTimeSeconds 86472 -SADataSizeKilobytes 429497 -IkeEncryption AES256 -IkeIntegrity SHA256 -DhGroup DHGroup2 -PfsGroup None
PS C:\> $gateway = Set-AzureRmVirtualNetworkGateway -VirtualNetworkGateway $Gateway -VpnClientIpsecPolicy $vpnclientipsecpolicy

El primer comando obtiene una puerta de enlace de red virtual denominada Gateway01 que pertenece al grupo de recursos ResourceGroup001 y la almacena en la variable denominada $Gateway El segundo comando crea el objeto de directiva ipsec vpn según los parámetros ipsec especificados. El tercer comando establece el estado objetivo de la puerta de enlace de red virtual almacenada en la variable $Gateway. El comando también establece la directiva ipsec vpn personalizada especificada en el objeto $vpnclientipsecpolicy en la puerta de enlace de red virtual.

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

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

-Asn

Especifica el número de sistema autónomo (ASN) de puerta de enlace de red virtual que se usa para configurar sesiones del Protocolo de puerta de enlace de borde (BGP) dentro de túneles IPsec.

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

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:	IAzureContextContainer
Alias:	AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableActiveActiveFeature

Deshabilita la característica activa-activa.

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

-EnableActiveActiveFeature

Habilita la característica activa-activa.

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

-GatewayDefaultSite

Especifica el sitio predeterminado que se va a usar para la tunelización forzada. Si se especifica un sitio predeterminado, todo el tráfico de Internet de la red privada virtual (VPN) de la puerta de enlace se enruta a ese sitio.

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

-GatewaySku

Especifica la unidad de almacenamiento de existencias (SKU) de la puerta de enlace de red virtual. Los valores permitidos para este parámetro son los siguientes:

• Básico
• Estándar
• HighPerformance
• VpnGw1
• VpnGw2
• VpnGw3
• VpnGw1AZ
• VpnGw2AZ
• VpnGw3AZ
• ErGw1AZ
• ErGw2AZ
• ErGw3AZ

Tipo:	String
Valores aceptados:	Basic, Standard, HighPerformance, UltraPerformance, VpnGw1, VpnGw2, VpnGw3, VpnGw1AZ, VpnGw2AZ, VpnGw3AZ, ErGw1AZ, ErGw2AZ, ErGw3AZ
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-PeerWeight

Especifica el peso agregado a las rutas aprendidas a través de BGP desde esta puerta de enlace de red virtual.

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

-RadiusServerAddress

Dirección del servidor radius externo P2S.

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

-RadiusServerSecret

Secreto del servidor De radio externo P2S.

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

-VirtualNetworkGateway

Especifica el objeto de puerta de enlace de red virtual del que se van a basar las modificaciones. Puede usar el cmdlet Get-AzureRmVirtualNetworkGateway para obtener el objeto de puerta de enlace de red virtual.

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

-VpnClientAddressPool

Especifica el espacio de direcciones que usa este cmdlet para asignar direcciones IP de cliente VPN. Esto no debe superponerse con la red virtual o los intervalos locales.

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

-VpnClientIpsecPolicy

Lista de directivas IPSec para protocolos de tunelización de cliente VPN P2S.

Tipo:	List<T>[PSIpsecPolicy]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-VpnClientProtocol

Lista de protocolos de tunelización de cliente VPN P2S

Tipo:	List<T>[String]
Valores aceptados:	SSTP, IkeV2, OpenVPN
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-VpnClientRevokedCertificates

Especifica una lista de certificados de cliente VPN revocados. Se quita un cliente VPN que presenta un certificado que coincide con uno de estos.

Tipo:	List<T>[PSVpnClientRevokedCertificate]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-VpnClientRootCertificates

Especifica una lista de certificados raíz de cliente VPN que se van a usar para la autenticación de cliente VPN. La conexión de clientes VPN debe presentar certificados generados a partir de uno de estos certificados raíz.

Tipo:	List<T>[PSVpnClientRootCertificate]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

PSVirtualNetworkGateway

Parámetros: VirtualNetworkGateway (ByValue)

String

PSLocalNetworkGateway

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSVpnClientRootCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSVpnClientRevokedCertificate, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSIpsecPolicy, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

UInt32

Int32

SecureString

Salidas

PSVirtualNetworkGateway

Notas

• Palabras clave: azure, azurerm, arm, resource, management, manager, network, networking

Vínculos relacionados

• Get-AzureRmVirtualNetworkGateway
• New-AzureRmVirtualNetworkGateway
• Remove-AzureRmVirtualNetworkGateway
• Reset-AzureRmVirtualNetworkGateway
• Resize-AzureRmVirtualNetworkGateway