Compartir a través de

New-AzureRmApplicationGateway

  • Referencia
Módulo:
AzureRM.Network

Crea una puerta de enlace de aplicaciones.

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.

Sintaxis

New-AzureRmApplicationGateway
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <PSApplicationGatewaySku>
   [-SslPolicy <PSApplicationGatewaySslPolicy>]
   -GatewayIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayIPConfiguration]>
   [-SslCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewaySslCertificate]>]
   [-AuthenticationCertificates <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayAuthenticationCertificate]>]
   [-TrustedRootCertificate <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayTrustedRootCertificate]>]
   [-FrontendIPConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendIPConfiguration]>]
   -FrontendPorts <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFrontendPort]>
   [-Probes <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayProbe]>]
   -BackendAddressPools <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>
   -BackendHttpSettingsCollection <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendHttpSettings]>
   -HttpListeners <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayHttpListener]>
   [-UrlPathMaps <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayUrlPathMap]>]
   -RequestRoutingRules <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRequestRoutingRule]>
   [-RedirectConfigurations <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayRedirectConfiguration]>]
   [-WebApplicationFirewallConfiguration <PSApplicationGatewayWebApplicationFirewallConfiguration>]
   [-AutoscaleConfiguration <PSApplicationGatewayAutoscaleConfiguration>]
   [-EnableHttp2]
   [-EnableFIPS]
   [-Zone <System.Collections.Generic.List`1[System.String]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzureRmApplicationGateway crea una puerta de enlace de aplicaciones de Azure. Una puerta de enlace de aplicaciones requiere lo siguiente:

  • Un grupo de recursos.
  • Una red virtual.
  • Un grupo de servidores back-end que contiene las direcciones IP de los servidores back-end.
  • Configuración del grupo de servidores back-end. Cada grupo tiene configuraciones como puerto, protocolo y afinidad basada en cookies, que se aplican a todos los servidores del grupo.
  • Direcciones IP de front-end, que son las direcciones IP abiertas en la puerta de enlace de aplicaciones. Una dirección IP de front-end puede ser una dirección IP pública o una dirección IP interna.
  • Puertos front-end, que son los puertos públicos abiertos en la puerta de enlace de aplicaciones. El tráfico que llega a estos puertos se redirige a los servidores back-end.
  • Regla de enrutamiento de solicitudes que enlaza el agente de escucha y el grupo de servidores back-end. La regla define a qué grupo de servidores back-end se debe dirigir el tráfico cuando llega a un agente de escucha determinado. Un agente de escucha tiene un puerto front-end, una dirección IP de front-end, un protocolo (HTTP o HTTPS) y un nombre de certificado de capa de sockets seguros (SSL) (si se configura la descarga SSL).

Ejemplos

Ejemplo 1: Creación de una puerta de enlace de aplicaciones

PS C:\> $ResourceGroup = New-AzureRmResourceGroup -Name "ResourceGroup01" -Location "West US" -Tag @{Name = "Department"; Value = "Marketing"} 
PS C:\> $Subnet = New-AzureRmVirtualNetworkSubnetConfig -Name "Subnet01" -AddressPrefix 10.0.0.0/24
PS C:\> $VNet = New-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01" -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $Subnet
PS C:\> $VNet = Get-AzureRmvirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
PS C:\> $Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name $Subnet01 -VirtualNetwork $VNet 
PS C:\> $GatewayIPconfig = New-AzureRmApplicationGatewayIPConfiguration -Name "GatewayIp01" -Subnet $Subnet
PS C:\> $Pool = New-AzureRmApplicationGatewayBackendAddressPool -Name "Pool01" -BackendIPAddresses 10.10.10.1, 10.10.10.2, 10.10.10.3
PS C:\> $PoolSetting = New-AzureRmApplicationGatewayBackendHttpSettings -Name "PoolSetting01"  -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $FrontEndPort = New-AzureRmApplicationGatewayFrontendPort -Name "FrontEndPort01"  -Port 80
# Create a public IP address
PS C:\> $PublicIp = New-AzureRmPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIpName01" -Location "West US" -AllocationMethod "Dynamic"
PS C:\> $FrontEndIpConfig = New-AzureRmApplicationGatewayFrontendIPConfig -Name "FrontEndConfig01" -PublicIPAddress $PublicIp
PS C:\> $Listener = New-AzureRmApplicationGatewayHttpListener -Name "ListenerName01"  -Protocol "Http" -FrontendIpConfiguration $FrontEndIpConfig -FrontendPort $FrontEndPort
PS C:\> $Rule = New-AzureRmApplicationGatewayRequestRoutingRule -Name "Rule01" -RuleType basic -BackendHttpSettings $PoolSetting -HttpListener $Listener -BackendAddressPool $Pool
PS C:\> $Sku = New-AzureRmApplicationGatewaySku -Name "Standard_Small" -Tier Standard -Capacity 2
PS C:\> $Gateway = New-AzureRmApplicationGateway -Name "AppGateway01" -ResourceGroupName "ResourceGroup01" -Location "West US" -BackendAddressPools $Pool -BackendHttpSettingsCollection $PoolSetting -FrontendIpConfigurations $FrontEndIpConfig  -GatewayIpConfigurations $GatewayIpConfig -FrontendPorts $FrontEndPort -HttpListeners $Listener -RequestRoutingRules $Rule -Sku $Sku

En el ejemplo siguiente se crea una puerta de enlace de aplicaciones creando primero un grupo de recursos y una red virtual, así como lo siguiente:

  • Un grupo de servidores back-end
  • Configuración del grupo de servidores back-end
  • Puertos de front-end
  • Direcciones IP de front-end
  • Regla de enrutamiento de solicitudes Estos cuatro comandos crean una red virtual. El primer comando crea una configuración de subred. El segundo comando crea una red virtual. El tercer comando comprueba la configuración de la subred y el cuarto comando comprueba que la red virtual se crea correctamente. Los comandos siguientes crean la puerta de enlace de aplicaciones. El primer comando crea una configuración de IP denominada GatewayIp01 para la subred creada anteriormente. El segundo comando crea un grupo de servidores back-end denominado Pool01 con una lista de direcciones IP de back-end y almacena el grupo en la variable $Pool. El tercer comando crea la configuración del grupo de servidores back-end y almacena la configuración en la variable $PoolSetting. El comando forth crea un puerto front-end en el puerto 80, le asigna un nombre FrontEndPort01 y almacena el puerto en la variable $FrontEndPort. El quinto comando crea una dirección IP pública mediante New-AzureRmPublicIpAddress. El sexto comando crea una configuración de IP de front-end mediante $PublicIp, le asigna un nombre FrontEndPortConfig01 y la almacena en la variable $FrontEndIpConfig. El séptimo comando crea un agente de escucha mediante el $FrontEndIpConfig $FrontEndPort creado anteriormente. El octavo comando crea una regla para el agente de escucha. El noveno comando establece la SKU. El décimo comando crea la puerta de enlace mediante los objetos establecidos por los comandos anteriores.

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

-AuthenticationCertificates

Especifica certificados de autenticación para la puerta de enlace de aplicaciones.

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

-AutoscaleConfiguration

Configuración de escalado automático

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

-BackendAddressPools

Especifica la lista de grupos de direcciones de back-end para la puerta de enlace de aplicaciones.

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

-BackendHttpSettingsCollection

Especifica la lista de configuraciones HTTP de back-end para la puerta de enlace de aplicaciones.

Tipo:List<T>[PSApplicationGatewayBackendHttpSettings]
Posición:Named
Valor predeterminado:None
Requerido:True
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:False
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

-EnableFIPS

Indica si FIPS está habilitado.

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

-EnableHttp2

Si HTTP2 está habilitado.

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

-Force

Obliga al comando a ejecutarse sin solicitar la confirmación del usuario.

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

-FrontendIPConfigurations

Especifica una lista de configuraciones ip de front-end para la puerta de enlace de aplicaciones.

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

-FrontendPorts

Especifica una lista de puertos front-end para la puerta de enlace de aplicaciones.

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

-GatewayIPConfigurations

Especifica una lista de configuraciones ip para la puerta de enlace de aplicaciones.

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

-HttpListeners

Especifica una lista de agentes de escucha HTTP para la puerta de enlace de aplicaciones.

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

-Location

Especifica la región en la que se va a crear la puerta de enlace de aplicaciones.

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

-Name

Especifica el nombre de la puerta de enlace de aplicaciones.

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

-Probes

Especifica sondeos para la puerta de enlace de aplicaciones.

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

-RedirectConfigurations

Lista de la configuración de redireccionamiento

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

-RequestRoutingRules

Especifica una lista de reglas de enrutamiento de solicitudes para la puerta de enlace de aplicaciones.

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

-ResourceGroupName

Especifica el nombre del grupo de recursos en el que se va a crear la puerta de enlace de aplicaciones.

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

-Sku

Especifica la unidad de almacenamiento de existencias (SKU) de la puerta de enlace de aplicaciones.

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

-SslCertificates

Especifica la lista de certificados de capa de sockets seguros (SSL) para la puerta de enlace de aplicaciones.

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

-SslPolicy

Especifica una directiva SSL para la puerta de enlace de aplicaciones.

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

-Tag

Pares clave-valor en forma de tabla hash. Por ejemplo: @{key0="value0"; key1=$null; key2="value2"}

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

-TrustedRootCertificate

Lista de certificados raíz de confianza

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

-UrlPathMaps

Especifica las asignaciones de rutas de acceso de dirección URL para la puerta de enlace de aplicaciones.

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

-WebApplicationFirewallConfiguration

Especifica una configuración de firewall de aplicaciones web (WAF). Puede usar el cmdlet Get-AzureRmApplicationGatewayWebApplicationFirewallConfiguration para obtener un WAF.

Tipo:PSApplicationGatewayWebApplicationFirewallConfiguration
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:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Zone

Lista de zonas de disponibilidad en las que debe proceder la puerta de enlace de aplicaciones.

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

Entradas

String

PSApplicationGatewaySku

PSApplicationGatewaySslPolicy

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

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

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

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

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

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

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

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

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

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

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

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

PSApplicationGatewayWebApplicationFirewallConfiguration

Hashtable

Salidas

PSApplicationGateway