Compartir a través de

Set-AzureRmApplicationGatewayFrontendIPConfig

  • Referencia
Módulo:
AzureRM.Network

Modifica una configuración de dirección IP de front-end.

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-AzureRmApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-SubnetId <String>]
   [-PublicIPAddressId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmApplicationGatewayFrontendIPConfig
   -ApplicationGateway <PSApplicationGateway>
   -Name <String>
   [-PrivateIPAddress <String>]
   [-Subnet <PSSubnet>]
   [-PublicIPAddress <PSPublicIpAddress>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Set-AzureRmApplicationGatewayFrontendIPConfig actualiza una configuración de IP de front-end. Una puerta de enlace de aplicaciones admite dos tipos de direcciones IP de front-end:

  • Direcciones IP públicas
  • Direcciones IP privadas para las que la configuración usa equilibrio de carga interno (ILB) Una puerta de enlace de aplicaciones puede tener como máximo una dirección IP pública y una dirección IP privada. Una dirección IP pública y una dirección IP privada deben agregarse por separado como direcciones IP de front-end.

Ejemplos

Ejemplo 1: Establecimiento de una dirección IP pública como IP de front-end de una puerta de enlace de aplicaciones

PS C:\>$PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontEndIp01" -PublicIPAddress $PublicIp

El primer comando crea un objeto de dirección IP pública y lo almacena en la variable $PublicIp. El segundo comando obtiene la puerta de enlace de aplicaciones denominada ApplicationGateway01 que pertenece al grupo de recursos denominado ResourceGroup01 y la almacena en la variable $AppGw. El tercer comando actualiza la configuración ip de front-end denominada FrontEndIp01, para la puerta de enlace en $AppGw, mediante la dirección almacenada en $PublicIp.

Ejemplo 2: Establecimiento de una dirección IP privada estática como ip de front-end de una puerta de enlace de aplicaciones

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet -PrivateIPAddress 10.0.1.1

El primer comando obtiene una red virtual denominada VNet01 que pertenece al grupo de recursos denominado ResourceGroup01 y la almacena en la variable $VNet. El segundo comando obtiene una configuración de subred denominada Subnet01 mediante $VNet del primer comando y la almacena en la variable $Subnet. El tercer comando obtiene la puerta de enlace de aplicaciones denominada ApplicationGateway01 que pertenece al grupo de recursos denominado ResourceGroup01 y la almacena en la variable $AppGw. El cuarto comando agrega una configuración ip de front-end denominada FrontendIP02 mediante $Subnet del segundo comando y la dirección IP privada 10.0.1.1.

Ejemplo 3: Establecimiento de una dirección IP privada dinámica como dirección IP de front-end de una puerta de enlace de aplicaciones

PS C:\>$VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
PS C:\> $AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
PS C:\> $AppGw = Set-AzureRmApplicationGatewayFrontendIPConfig -ApplicationGateway $AppGw -Name "FrontendIP02" -Subnet $Subnet

El primer comando obtiene una red virtual denominada VNet01 que pertenece al grupo de recursos denominado ResourceGroup01 y la almacena en la variable $VNet. El segundo comando obtiene una configuración de subred denominada Subnet01 mediante $VNet del primer comando y la almacena en la variable $Subnet. El tercer comando obtiene la puerta de enlace de aplicaciones denominada ApplicationGateway01 que pertenece al grupo de recursos denominado ResourceGroup01 y la almacena en la variable $AppGw. El cuarto comando agrega una configuración ip de front-end denominada FrontendIP02 mediante $Subnet del segundo comando.

Parámetros

-ApplicationGateway

Especifica un objeto de puerta de enlace de aplicaciones en el que se va a modificar la configuración de IP de front-end.

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

-Name

Especifica el nombre de la configuración de IP de front-end que modifica este cmdlet.

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

-PrivateIPAddress

Especifica la dirección IP privada. Si se especifica, esta dirección IP se asigna estáticamente desde la subred.

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

-PublicIPAddress

Especifica la dirección IP pública.

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

-PublicIPAddressId

Especifica el identificador de la dirección IP pública.

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

-Subnet

Especifica la subred que usa la puerta de enlace de aplicaciones. Especifique este parámetro si la puerta de enlace usa una dirección IP privada. Si se especifica la dirección PrivateIPAddress , debe pertenecer a esta subred. Si no se especifica PrivateIPAddress , una de las direcciones IP de esta subred se selecciona dinámicamente como dirección IP de front-end de la puerta de enlace de aplicaciones.

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

-SubnetId

Especifica el identificador de subred. Especifique este parámetro si la puerta de enlace usa una dirección IP privada. Si se especifica el parámetro PrivateIPAddress , debe pertenecer a esta subred. Si no se especifica PrivateIPAddress , una de las direcciones IP de esta subred se selecciona dinámicamente como dirección IP de front-end de la puerta de enlace de aplicaciones.

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

Entradas

PSApplicationGateway

Parámetros: ApplicationGateway (ByValue)

Salidas

PSApplicationGateway