Set-AzureRmVirtualNetworkGateway

Módulo:

AzureRM.Network

Novedades una puerta de enlace de red virtual.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente 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 se mantiene ni se admite, colocando cualquier uso continuado 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.

Syntax

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
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Confirm

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

Tipo:	SwitchParameter
Aliases:	cf
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableActiveActiveFeature

Deshabilita la característica activa-activa.

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableActiveActiveFeature

Habilita la característica activa-activa.

Tipo:	SwitchParameter
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	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
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	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:

• Basic
• 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
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	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
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-RadiusServerAddress

Dirección del servidor radius externo P2S.

Tipo:	String
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-RadiusServerSecret

Secreto del servidor De radio externo P2S.

Tipo:	SecureString
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	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
Position:	Named
valor predeterminado:	None
Requerido:	True
Accept pipeline input:	True
Accept wildcard characters:	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]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VpnClientIpsecPolicy

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

Tipo:	List<T>[PSIpsecPolicy]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VpnClientProtocol

Lista de protocolos de tunelización de cliente VPN P2S

Tipo:	List<T>[String]
valores aceptados:	SSTP, IkeV2, OpenVPN
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	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]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VpnClientRootCertificates

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

Tipo:	List<T>[PSVpnClientRootCertificate]
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Tipo:	SwitchParameter
Aliases:	wi
Position:	Named
valor predeterminado:	None
Requerido:	False
Accept pipeline input:	False
Accept wildcard characters:	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