Compartir a través de

Update-AzVpnGateway

Módulo:
Az.Network Module

Actualiza una puerta de enlace de VPN escalable.

Sintaxis

ByVpnGatewayName (valor predeterminado) 

Update-AzVpnGateway
    -ResourceGroupName <String>
    -Name <String>
    [-VpnConnection <PSVpnConnection[]>]
    [-VpnGatewayNatRule <PSVpnGatewayNatRule[]>]
    [-VpnGatewayScaleUnit <UInt32>]
    [-BgpPeeringAddress <PSIpConfigurationBgpPeeringAddress[]>]
    [-EnableBgpRouteTranslationForNat <Boolean>]
    [-Tag <Hashtable>]
    [-Asn <UInt32>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVpnGatewayObject 

Update-AzVpnGateway
    -InputObject <PSVpnGateway>
    [-VpnConnection <PSVpnConnection[]>]
    [-VpnGatewayNatRule <PSVpnGatewayNatRule[]>]
    [-VpnGatewayScaleUnit <UInt32>]
    [-BgpPeeringAddress <PSIpConfigurationBgpPeeringAddress[]>]
    [-EnableBgpRouteTranslationForNat <Boolean>]
    [-Tag <Hashtable>]
    [-Asn <UInt32>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByVpnGatewayResourceId 

Update-AzVpnGateway
    -ResourceId <String>
    [-VpnConnection <PSVpnConnection[]>]
    [-VpnGatewayNatRule <PSVpnGatewayNatRule[]>]
    [-VpnGatewayScaleUnit <UInt32>]
    [-BgpPeeringAddress <PSIpConfigurationBgpPeeringAddress[]>]
    [-EnableBgpRouteTranslationForNat <Boolean>]
    [-Tag <Hashtable>]
    [-Asn <UInt32>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

El cmdlet Update-AzVpnGateway actualiza una puerta de enlace de VPN escalable. Una puerta de enlace de VPN de Azure es una conectividad definida por software para las conexiones de sitio a sitio dentro de VirtualHub. Esta puerta de enlace cambia el tamaño y se escala en función de la unidad de escalado especificada por el usuario. Una conexión se puede configurar desde una rama o sitio conocido como sitio VPN a la puerta de enlace escalable. Cada conexión consta de 2 túneles Active-Active

Ejemplos

Ejemplo 1

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
$vpnGateway = New-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -VirtualHubId $virtualHub.Id -VpnGatewayScaleUnit 2
Update-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -VpnGatewayScaleUnit 3

ResourceGroupName   : testRG
Name                : testvpngw
Id                  : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/vpnGateways/testvpngw
Location            : West US
VpnGatewayScaleUnit : 3
VirtualHub          : /subscriptions/{subscriptionId}/resourceGroups/Ali_pS_Test/providers/Microsoft.Network/virtualHubs/westushub
BgpSettings         : {}
Type                : Microsoft.Network/vpnGateways
ProvisioningState   : Succeeded

Lo anterior creará un grupo de recursos, Virtual WAN, Virtual Network, Virtual Hub en Oeste de EE. UU. en el grupo de recursos "testRG" en Azure. Una puerta de enlace de VPN se creará después en el centro de conectividad virtual con 2 unidades de escalado.

Una vez creada la puerta de enlace, usa Update-AzVpnGateway para actualizar la puerta de enlace a 3 unidades de escalado.

Ejemplo 2

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
$vpnGateway = New-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -VirtualHubId $virtualHub.Id -VpnGatewayScaleUnit 2
$ipconfigurationId1 = 'Instance0'
$addresslist1 = @('169.254.21.5')
$gw1ipconfBgp1 = New-AzIpConfigurationBgpPeeringAddressObject -IpConfigurationId $ipconfigurationId1 -CustomAddress $addresslist1
$ipconfigurationId2 = 'Instance1'
$addresslist2 = @('169.254.21.10')
$gw1ipconfBgp2 = New-AzIpConfigurationBgpPeeringAddressObject -IpConfigurationId $ipconfigurationId2 -CustomAddress $addresslist2
$gw = Get-AzVpnGateway -ResourceGroupName testRg -Name testgw
Update-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -BgpPeeringAddress @($gw1ipconfBgp1,$gw1ipconfBgp2)

ResourceGroupName   : testRG
Name                : testvpngw
Id                  : /subscriptions/{subscriptionId}/resourceGroups/testRG/providers/Microsoft.Network/vpnGateways/testvpngw
Location            : West US
VpnGatewayScaleUnit : 3
VirtualHub          : /subscriptions/{subscriptionId}/resourceGroups/Ali_pS_Test/providers/Microsoft.Network/virtualHubs/westushub
BgpSettings         : {}
Type                : Microsoft.Network/vpnGateways
ProvisioningState   : Succeeded

Lo anterior creará un grupo de recursos, Virtual WAN, Virtual Network, Virtual Hub en Oeste de EE. UU. en el grupo de recursos "testRG" en Azure. Una puerta de enlace de VPN se creará después en el centro de conectividad virtual con 2 unidades de escalado.

Una vez creada la puerta de enlace, usa Set-AzVpnGateway para actualizar BgpPeeringAddress.

Ejemplo 3

$gw = Get-AzVpnGateway -ResourceGroupName "testRg" -Name "testgw"
$gw.BgpSettings.BgpPeeringAddresses
$gw.BgpSettings.BgpPeeringAddresses[0].CustomBgpIpAddresses=$null
$gw.BgpSettings.BgpPeeringAddresses[1].CustomBgpIpAddresses=$null
$gw.BgpSettings.BgpPeeringAddresses
Update-AzVpnGateway -InputObject $gw

En el ejemplo anterior se actualizará la puerta de enlace de VPN de Virtual WAN para usar el BgpPeeringAddress predeterminado.

Ejemplo 4

New-AzResourceGroup -Location "West US" -Name "testRG"
$virtualWan = New-AzVirtualWan -ResourceGroupName testRG -Name myVirtualWAN -Location "West US"
$virtualHub = New-AzVirtualHub -VirtualWan $virtualWan -ResourceGroupName "testRG" -Name "westushub" -AddressPrefix "10.0.0.1/24"
$vpnGateway = New-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -VirtualHubId $virtualHub.Id -VpnGatewayScaleUnit 2
$ipconfigurationId1 = 'Instance0'
$addresslist1 = @()
$gw1ipconfBgp1 = New-AzIpConfigurationBgpPeeringAddressObject -IpConfigurationId $ipconfigurationId1 -CustomAddress $addresslist1
$ipconfigurationId2 = 'Instance1'
$addresslist2 = @()
$gw1ipconfBgp2 = New-AzIpConfigurationBgpPeeringAddressObject -IpConfigurationId $ipconfigurationId2 -CustomAddress $addresslist2
$gw = Get-AzVpnGateway -ResourceGroupName testRg -Name testgw
Update-AzVpnGateway -ResourceGroupName "testRG" -Name "testvpngw" -BgpPeeringAddress @($gw1ipconfBgp1,$gw1ipconfBgp2)

En el ejemplo anterior se actualizará la puerta de enlace de VPN de Virtual WAN para usar el BgpPeeringAddress predeterminado.

Usa Update-AzVpnGateway para actualizar BgpPeeringAddress

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Asn

ASN de vpn Gateway para BGP a través de VPN

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-BgpPeeringAddress

Las direcciones de emparejamiento BGP para este vpnGateway bgpsettings.

Propiedades de parámetro

Tipo:

PSIpConfigurationBgpPeeringAddress[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-EnableBgpRouteTranslationForNat

Marca para habilitar o deshabilitar la traducción de rutas Bgp para NAT en esta vpnGateway.

Propiedades de parámetro

Tipo:

Nullable<T>[Boolean]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-InputObject

Objeto de puerta de enlace de VPN que se va a modificar

Propiedades de parámetro

Tipo:PSVpnGateway
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:VpnGateway

Conjuntos de parámetros

ByVpnGatewayObject
Posición:Named
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Nombre de la puerta de enlace de VPN.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:nombreDelRecurso, VpnGatewayName, NombreDelGateway

Conjuntos de parámetros

ByVpnGatewayName
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceGroupName

Nombre del grupo de recursos.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByVpnGatewayName
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ResourceId

Identificador de recurso de Azure de VpnGateway que se va a modificar.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

ByVpnGatewayResourceId
Posición:Named
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Tag

Tabla hash que representa etiquetas de recursos.

Propiedades de parámetro

Tipo:Hashtable
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-VpnConnection

La lista de VpnConnections que debe tener este VpnGateway.

Propiedades de parámetro

Tipo:

PSVpnConnection[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-VpnGatewayNatRule

La lista de VpnGatewayNatRules asociados a este VpnGateway.

Propiedades de parámetro

Tipo:

PSVpnGatewayNatRule[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-VpnGatewayScaleUnit

Unidad de escalado para este VpnGateway.

Propiedades de parámetro

Tipo:UInt32
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSVpnGateway

String

Salidas

PSVpnGateway