Compartir a través de


Set-AzApplicationGatewayFrontendIPConfig

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

Sintaxis

SetByResourceId

Set-AzApplicationGatewayFrontendIPConfig
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    [-PrivateIPAddress <String>]
    [-SubnetId <String>]
    [-PublicIPAddressId <String>]
    [-PrivateLinkConfigurationId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource

Set-AzApplicationGatewayFrontendIPConfig
    -ApplicationGateway <PSApplicationGateway>
    -Name <String>
    [-PrivateIPAddress <String>]
    [-Subnet <PSSubnet>]
    [-PublicIPAddress <PSPublicIpAddress>]
    [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

El cmdlet Set-AzApplicationGatewayFrontendIPConfig 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

$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIp01" -location "West US" -AllocationMethod Dynamic
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -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

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -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

$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet
$AppGw = Get-AzApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"
$AppGw = Set-AzApplicationGatewayFrontendIPConfig -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.

Propiedades de parámetro

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

Conjuntos de parámetros

(All)
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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan 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

-Name

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

Propiedades de parámetro

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

Conjuntos de parámetros

(All)
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

-PrivateIPAddress

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

Propiedades de parámetro

Tipo:String
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

-PrivateLinkConfiguration

PrivateLinkConfiguration

Propiedades de parámetro

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

Conjuntos de parámetros

SetByResource
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

-PrivateLinkConfigurationId

PrivateLinkConfigurationId

Propiedades de parámetro

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

Conjuntos de parámetros

SetByResourceId
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

-PublicIPAddress

Especifica la dirección IP pública.

Propiedades de parámetro

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

Conjuntos de parámetros

SetByResource
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

-PublicIPAddressId

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

Propiedades de parámetro

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

Conjuntos de parámetros

SetByResourceId
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

-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.

Propiedades de parámetro

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

Conjuntos de parámetros

SetByResource
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

-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.

Propiedades de parámetro

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

Conjuntos de parámetros

SetByResourceId
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

PSApplicationGateway

Salidas

PSApplicationGateway