New-AzApplicationGateway

  • Reference
Module:
Az.Network

Creates an application gateway.

Syntax

New-AzApplicationGateway
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <PSApplicationGatewaySku>
   [-SslPolicy <PSApplicationGatewaySslPolicy>]
   -GatewayIPConfigurations <PSApplicationGatewayIPConfiguration[]>
   [-SslCertificates <PSApplicationGatewaySslCertificate[]>]
   [-AuthenticationCertificates <PSApplicationGatewayAuthenticationCertificate[]>]
   [-TrustedRootCertificate <PSApplicationGatewayTrustedRootCertificate[]>]
   [-TrustedClientCertificates <PSApplicationGatewayTrustedClientCertificate[]>]
   [-FrontendIPConfigurations <PSApplicationGatewayFrontendIPConfiguration[]>]
   -FrontendPorts <PSApplicationGatewayFrontendPort[]>
   [-Probes <PSApplicationGatewayProbe[]>]
   -BackendAddressPools <PSApplicationGatewayBackendAddressPool[]>
   [-BackendHttpSettingsCollection <PSApplicationGatewayBackendHttpSettings[]>]
   [-BackendSettingsCollection <PSApplicationGatewayBackendSettings[]>]
   [-SslProfiles <PSApplicationGatewaySslProfile[]>]
   [-HttpListeners <PSApplicationGatewayHttpListener[]>]
   [-Listeners <PSApplicationGatewayListener[]>]
   [-UrlPathMaps <PSApplicationGatewayUrlPathMap[]>]
   [-RequestRoutingRules <PSApplicationGatewayRequestRoutingRule[]>]
   [-RoutingRules <PSApplicationGatewayRoutingRule[]>]
   [-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet[]>]
   [-RedirectConfigurations <PSApplicationGatewayRedirectConfiguration[]>]
   [-WebApplicationFirewallConfiguration <PSApplicationGatewayWebApplicationFirewallConfiguration>]
   [-AutoscaleConfiguration <PSApplicationGatewayAutoscaleConfiguration>]
   [-EnableHttp2]
   [-EnableFIPS]
   [-EnableRequestBuffering <Boolean>]
   [-EnableResponseBuffering <Boolean>]
   [-ForceFirewallPolicyAssociation]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   [-UserAssignedIdentityId <String>]
   [-Force]
   [-AsJob]
   [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
   [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzApplicationGateway
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <PSApplicationGatewaySku>
   [-SslPolicy <PSApplicationGatewaySslPolicy>]
   -GatewayIPConfigurations <PSApplicationGatewayIPConfiguration[]>
   [-SslCertificates <PSApplicationGatewaySslCertificate[]>]
   [-AuthenticationCertificates <PSApplicationGatewayAuthenticationCertificate[]>]
   [-TrustedRootCertificate <PSApplicationGatewayTrustedRootCertificate[]>]
   [-TrustedClientCertificates <PSApplicationGatewayTrustedClientCertificate[]>]
   [-FrontendIPConfigurations <PSApplicationGatewayFrontendIPConfiguration[]>]
   -FrontendPorts <PSApplicationGatewayFrontendPort[]>
   [-Probes <PSApplicationGatewayProbe[]>]
   -BackendAddressPools <PSApplicationGatewayBackendAddressPool[]>
   [-BackendHttpSettingsCollection <PSApplicationGatewayBackendHttpSettings[]>]
   [-BackendSettingsCollection <PSApplicationGatewayBackendSettings[]>]
   [-SslProfiles <PSApplicationGatewaySslProfile[]>]
   [-HttpListeners <PSApplicationGatewayHttpListener[]>]
   [-Listeners <PSApplicationGatewayListener[]>]
   [-UrlPathMaps <PSApplicationGatewayUrlPathMap[]>]
   [-RequestRoutingRules <PSApplicationGatewayRequestRoutingRule[]>]
   [-RoutingRules <PSApplicationGatewayRoutingRule[]>]
   [-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet[]>]
   [-RedirectConfigurations <PSApplicationGatewayRedirectConfiguration[]>]
   [-WebApplicationFirewallConfiguration <PSApplicationGatewayWebApplicationFirewallConfiguration>]
   [-FirewallPolicyId <String>]
   [-AutoscaleConfiguration <PSApplicationGatewayAutoscaleConfiguration>]
   [-EnableHttp2]
   [-EnableFIPS]
   [-EnableRequestBuffering <Boolean>]
   [-EnableResponseBuffering <Boolean>]
   [-ForceFirewallPolicyAssociation]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
   [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzApplicationGateway
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <PSApplicationGatewaySku>
   [-SslPolicy <PSApplicationGatewaySslPolicy>]
   -GatewayIPConfigurations <PSApplicationGatewayIPConfiguration[]>
   [-SslCertificates <PSApplicationGatewaySslCertificate[]>]
   [-AuthenticationCertificates <PSApplicationGatewayAuthenticationCertificate[]>]
   [-TrustedRootCertificate <PSApplicationGatewayTrustedRootCertificate[]>]
   [-TrustedClientCertificates <PSApplicationGatewayTrustedClientCertificate[]>]
   [-FrontendIPConfigurations <PSApplicationGatewayFrontendIPConfiguration[]>]
   -FrontendPorts <PSApplicationGatewayFrontendPort[]>
   [-Probes <PSApplicationGatewayProbe[]>]
   -BackendAddressPools <PSApplicationGatewayBackendAddressPool[]>
   [-BackendHttpSettingsCollection <PSApplicationGatewayBackendHttpSettings[]>]
   [-BackendSettingsCollection <PSApplicationGatewayBackendSettings[]>]
   [-SslProfiles <PSApplicationGatewaySslProfile[]>]
   [-HttpListeners <PSApplicationGatewayHttpListener[]>]
   [-Listeners <PSApplicationGatewayListener[]>]
   [-UrlPathMaps <PSApplicationGatewayUrlPathMap[]>]
   [-RequestRoutingRules <PSApplicationGatewayRequestRoutingRule[]>]
   [-RoutingRules <PSApplicationGatewayRoutingRule[]>]
   [-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet[]>]
   [-RedirectConfigurations <PSApplicationGatewayRedirectConfiguration[]>]
   [-WebApplicationFirewallConfiguration <PSApplicationGatewayWebApplicationFirewallConfiguration>]
   [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
   [-AutoscaleConfiguration <PSApplicationGatewayAutoscaleConfiguration>]
   [-EnableHttp2]
   [-EnableFIPS]
   [-EnableRequestBuffering <Boolean>]
   [-EnableResponseBuffering <Boolean>]
   [-ForceFirewallPolicyAssociation]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   [-Force]
   [-AsJob]
   [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
   [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzApplicationGateway
   -Name <String>
   -ResourceGroupName <String>
   -Location <String>
   -Sku <PSApplicationGatewaySku>
   [-SslPolicy <PSApplicationGatewaySslPolicy>]
   -GatewayIPConfigurations <PSApplicationGatewayIPConfiguration[]>
   [-SslCertificates <PSApplicationGatewaySslCertificate[]>]
   [-AuthenticationCertificates <PSApplicationGatewayAuthenticationCertificate[]>]
   [-TrustedRootCertificate <PSApplicationGatewayTrustedRootCertificate[]>]
   [-TrustedClientCertificates <PSApplicationGatewayTrustedClientCertificate[]>]
   [-FrontendIPConfigurations <PSApplicationGatewayFrontendIPConfiguration[]>]
   -FrontendPorts <PSApplicationGatewayFrontendPort[]>
   [-Probes <PSApplicationGatewayProbe[]>]
   -BackendAddressPools <PSApplicationGatewayBackendAddressPool[]>
   [-BackendHttpSettingsCollection <PSApplicationGatewayBackendHttpSettings[]>]
   [-BackendSettingsCollection <PSApplicationGatewayBackendSettings[]>]
   [-SslProfiles <PSApplicationGatewaySslProfile[]>]
   [-HttpListeners <PSApplicationGatewayHttpListener[]>]
   [-Listeners <PSApplicationGatewayListener[]>]
   [-UrlPathMaps <PSApplicationGatewayUrlPathMap[]>]
   [-RequestRoutingRules <PSApplicationGatewayRequestRoutingRule[]>]
   [-RoutingRules <PSApplicationGatewayRoutingRule[]>]
   [-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet[]>]
   [-RedirectConfigurations <PSApplicationGatewayRedirectConfiguration[]>]
   [-WebApplicationFirewallConfiguration <PSApplicationGatewayWebApplicationFirewallConfiguration>]
   [-AutoscaleConfiguration <PSApplicationGatewayAutoscaleConfiguration>]
   [-EnableHttp2]
   [-EnableFIPS]
   [-EnableRequestBuffering <Boolean>]
   [-EnableResponseBuffering <Boolean>]
   [-ForceFirewallPolicyAssociation]
   [-Zone <String[]>]
   [-Tag <Hashtable>]
   -Identity <PSManagedServiceIdentity>
   [-Force]
   [-AsJob]
   [-CustomErrorConfiguration <PSApplicationGatewayCustomError[]>]
   [-PrivateLinkConfiguration <PSApplicationGatewayPrivateLinkConfiguration[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-AzApplicationGateway cmdlet creates an Azure application gateway. An application gateway requires the following:

  • A resource group.
  • A virtual network.
  • A back-end server pool, containing the IP addresses of the back-end servers.
  • Back-end server pool settings. Each pool has settings such as port, protocol and cookie-based affinity, that are applied to all servers within the pool.
  • Front-end IP addresses, which are the IP addresses opened on the application gateway. A front-end IP address can be a public IP address or an internal IP address.
  • Front-end ports, which are the public ports opened on the application gateway. Traffic that hits these ports is redirected to the back-end servers.
  • A request routing rule that binds the listener and the back-end server pool. The rule defines which back-end server pool the traffic should be directed to when it hits a particular listener. A listener has a front-end port, front-end IP address, protocol (HTTP or HTTPS) and Secure Sockets Layer (SSL) certificate name (if configuring SSL offload).

Note

There is a limitation that does not allow users to deploy a V2 application gateway that utilizes customer key vault for certificate storage and has a WAF policy associated to it. In the four parameter sets provided by the New-AzApplicationGateway cmdlet, the -Identity switch never coincides with the -FirewallPolicy or -FirewallPolicyID switch. Therefore, this cannot be done in one operation. The workaround is to have this done in multiple operations. Users must deploy a standard V2 Application Gateway with the managed identity, then change the sku to WAF_v2 and add the WAF policy.

Examples

Example 1: Create an application gateway

$ResourceGroup = New-AzResourceGroup -Name "ResourceGroup01" -Location "West US" -Tag @{Name = "Department"; Value = "Marketing"} 
$Subnet = New-AzVirtualNetworkSubnetConfig -Name "Subnet01" -AddressPrefix 10.0.0.0/24
$VNet = New-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01" -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $Subnet
$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name "Subnet01" -VirtualNetwork $VNet 
$GatewayIPconfig = New-AzApplicationGatewayIPConfiguration -Name "GatewayIp01" -Subnet $Subnet
$Pool = New-AzApplicationGatewayBackendAddressPool -Name "Pool01" -BackendIPAddresses 10.10.10.1, 10.10.10.2, 10.10.10.3
$PoolSetting = New-AzApplicationGatewayBackendHttpSetting -Name "PoolSetting01"  -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
$FrontEndPort = New-AzApplicationGatewayFrontendPort -Name "FrontEndPort01"  -Port 80
# Create a public IP address
$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIpName01" -Location "West US" -AllocationMethod "Dynamic"
$FrontEndIpConfig = New-AzApplicationGatewayFrontendIPConfig -Name "FrontEndConfig01" -PublicIPAddress $PublicIp
$Listener = New-AzApplicationGatewayHttpListener -Name "ListenerName01"  -Protocol "Http" -FrontendIpConfiguration $FrontEndIpConfig -FrontendPort $FrontEndPort
$Rule = New-AzApplicationGatewayRequestRoutingRule -Name "Rule01" -RuleType basic -BackendHttpSettings $PoolSetting -HttpListener $Listener -BackendAddressPool $Pool
$Sku = New-AzApplicationGatewaySku -Name "Standard_Small" -Tier Standard -Capacity 2
$Gateway = New-AzApplicationGateway -Name "AppGateway01" -ResourceGroupName "ResourceGroup01" -Location "West US" -BackendAddressPools $Pool -BackendHttpSettingsCollection $PoolSetting -FrontendIpConfigurations $FrontEndIpConfig  -GatewayIpConfigurations $GatewayIpConfig -FrontendPorts $FrontEndPort -HttpListeners $Listener -RequestRoutingRules $Rule -Sku $Sku

The following example creates an application gateway by first creating a resource group and a virtual network, as well as the following:

  • A back-end server pool
  • Back-end server pool settings
  • Front-end ports
  • Front-end IP addresses
  • A request routing rule These four commands create a virtual network. The first command creates a subnet configuration. The second command creates a virtual network. The third command verifies the subnet configuration and the fourth command verifies that the virtual network is created successfully. The following commands create the application gateway. The first command creates an IP configuration named GatewayIp01 for the subnet created previously. The second command creates a back-end server pool named Pool01 with a list of back-end IP addresses and stores the pool in the $Pool variable. The third command creates the settings for the back-end server pool and stores the settings in the $PoolSetting variable. The forth command creates a front-end port on port 80, names it FrontEndPort01, and stores the port in the $FrontEndPort variable. The fifth command creates a public IP address by using New-AzPublicIpAddress. The sixth command creates a front-end IP configuration using $PublicIp, names it FrontEndPortConfig01, and stores it in the $FrontEndIpConfig variable. The seventh command creates a listener using the previously created $FrontEndIpConfig $FrontEndPort. The eighth command creates a rule for the listener. The ninth command sets the SKU. The tenth command creates the gateway using the objects set by the previous commands.

Example 2: Create an application gateway with UserAssigned Identity

$ResourceGroup = New-AzResourceGroup -Name "ResourceGroup01" -Location "West US" -Tag @{Name = "Department"; Value = "Marketing"} 
$Subnet = New-AzVirtualNetworkSubnetConfig -Name "Subnet01" -AddressPrefix 10.0.0.0/24
$VNet = New-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01" -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $Subnet
$VNet = Get-AzVirtualNetwork -Name "VNet01" -ResourceGroupName "ResourceGroup01"
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name $Subnet01 -VirtualNetwork $VNet 
$GatewayIPconfig = New-AzApplicationGatewayIPConfiguration -Name "GatewayIp01" -Subnet $Subnet
$Pool = New-AzApplicationGatewayBackendAddressPool -Name "Pool01" -BackendIPAddresses 10.10.10.1, 10.10.10.2, 10.10.10.3
$PoolSetting = New-AzApplicationGatewayBackendHttpSetting -Name "PoolSetting01"  -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
$FrontEndPort = New-AzApplicationGatewayFrontendPort -Name "FrontEndPort01"  -Port 80
# Create a public IP address
$PublicIp = New-AzPublicIpAddress -ResourceGroupName "ResourceGroup01" -Name "PublicIpName01" -Location "West US" -AllocationMethod "Dynamic"
$FrontEndIpConfig = New-AzApplicationGatewayFrontendIPConfig -Name "FrontEndConfig01" -PublicIPAddress $PublicIp
$Listener = New-AzApplicationGatewayHttpListener -Name "ListenerName01"  -Protocol "Http" -FrontendIpConfiguration $FrontEndIpConfig -FrontendPort $FrontEndPort
$Rule = New-AzApplicationGatewayRequestRoutingRule -Name "Rule01" -RuleType basic -BackendHttpSettings $PoolSetting -HttpListener $Listener -BackendAddressPool $Pool
$Sku = New-AzApplicationGatewaySku -Name "Standard_Small" -Tier Standard -Capacity 2
$Identity = New-AzUserAssignedIdentity -Name "Identity01" -ResourceGroupName "ResourceGroup01" -Location "West US"
$AppgwIdentity = New-AzApplicationGatewayIdentity -UserAssignedIdentity $Identity.Id
$Gateway = New-AzApplicationGateway -Name "AppGateway01" -ResourceGroupName "ResourceGroup01" -Location "West US" -Identity $AppgwIdentity -BackendAddressPools $Pool -BackendHttpSettingsCollection $PoolSetting -FrontendIpConfigurations $FrontEndIpConfig  -GatewayIpConfigurations $GatewayIpConfig -FrontendPorts $FrontEndPort -HttpListeners $Listener -RequestRoutingRules $Rule -Sku $Sku

Parameters

-AsJob

Run cmdlet in the background

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticationCertificates

Specifies authentication certificates for the application gateway.

Type:PSApplicationGatewayAuthenticationCertificate[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AutoscaleConfiguration

Autoscale Configuration

Type:PSApplicationGatewayAutoscaleConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BackendAddressPools

Specifies the list of back-end address pools for the application gateway.

Type:PSApplicationGatewayBackendAddressPool[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BackendHttpSettingsCollection

Specifies the list of back-end HTTP settings for the application gateway.

Type:PSApplicationGatewayBackendHttpSettings[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-BackendSettingsCollection

The list of backend settings

Type:PSApplicationGatewayBackendSettings[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CustomErrorConfiguration

Customer error of an application gateway

Type:PSApplicationGatewayCustomError[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableFIPS

Whether FIPS is enabled.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableHttp2

Whether HTTP2 is enabled.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableRequestBuffering

Whether Request Buffering is enabled.

Type:Nullable<T>[Boolean]
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableResponseBuffering

Whether Response Buffering is enabled.

Type:Nullable<T>[Boolean]
Position:Named
Default value:True
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicy

Firewall configuration

Type:PSApplicationGatewayWebApplicationFirewallPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FirewallPolicyId

FirewallPolicyId

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Forces the command to run without asking for user confirmation.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceFirewallPolicyAssociation

Whether Force firewallPolicy association is enabled.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FrontendIPConfigurations

Specifies a list of front-end IP configurations for the application gateway.

Type:PSApplicationGatewayFrontendIPConfiguration[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-FrontendPorts

Specifies a list of front-end ports for the application gateway.

Type:PSApplicationGatewayFrontendPort[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-GatewayIPConfigurations

Specifies a list of IP configurations for the application gateway.

Type:PSApplicationGatewayIPConfiguration[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-HttpListeners

Specifies a list of HTTP listeners for the application gateway.

Type:PSApplicationGatewayHttpListener[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Identity

Application Gateway Identity to be assigned to Application Gateway.

Type:PSManagedServiceIdentity
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Listeners

The list of listener

Type:PSApplicationGatewayListener[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

Specifies the region in which to create the application gateway.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Specifies the name of application gateway.

Type:String
Aliases:ResourceName
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PrivateLinkConfiguration

The list of privateLink Configuration

Type:PSApplicationGatewayPrivateLinkConfiguration[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Probes

Specifies probes for the application gateway.

Type:PSApplicationGatewayProbe[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RedirectConfigurations

The list of redirect configuration

Type:PSApplicationGatewayRedirectConfiguration[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RequestRoutingRules

Specifies a list of request routing rules for the application gateway.

Type:PSApplicationGatewayRequestRoutingRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Specifies the name of the resource group in which to create the application gateway.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RewriteRuleSet

The list of RewriteRuleSet

Type:PSApplicationGatewayRewriteRuleSet[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RoutingRules

The list of routing rule

Type:PSApplicationGatewayRoutingRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Sku

Specifies the stock keeping unit (SKU) of the application gateway.

Type:PSApplicationGatewaySku
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SslCertificates

Specifies the list of Secure Sockets Layer (SSL) certificates for the application gateway.

Type:PSApplicationGatewaySslCertificate[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SslPolicy

Specifies an SSL policy for the application gateway.

Type:PSApplicationGatewaySslPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-SslProfiles

The list of ssl profiles

Type:PSApplicationGatewaySslProfile[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Tag

Key-value pairs in the form of a hash table. For example: @{key0="value0";key1=$null;key2="value2"}

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TrustedClientCertificates

The list of trusted client CA certificate chains

Type:PSApplicationGatewayTrustedClientCertificate[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TrustedRootCertificate

The list of trusted root certificates

Type:PSApplicationGatewayTrustedRootCertificate[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UrlPathMaps

Specifies URL path maps for the application gateway.

Type:PSApplicationGatewayUrlPathMap[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UserAssignedIdentityId

ResourceId of the user assigned identity to be assigned to Application Gateway.

Type:String
Aliases:UserAssignedIdentity
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WebApplicationFirewallConfiguration

Specifies a web application firewall (WAF) configuration. You can use the Get-AzApplicationGatewayWebApplicationFirewallConfiguration cmdlet to get a WAF.

Type:PSApplicationGatewayWebApplicationFirewallConfiguration
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Zone

A list of availability zones denoting where the application gateway needs to come from.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

String

PSApplicationGatewaySku

PSApplicationGatewaySslPolicy

PSApplicationGatewayIPConfiguration[]

PSApplicationGatewaySslCertificate[]

PSApplicationGatewayAuthenticationCertificate[]

PSApplicationGatewayTrustedRootCertificate[]

PSApplicationGatewayFrontendIPConfiguration[]

PSApplicationGatewayFrontendPort[]

PSApplicationGatewayProbe[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationGatewayBackendHttpSettings[]

PSApplicationGatewayHttpListener[]

PSApplicationGatewayUrlPathMap[]

PSApplicationGatewayRequestRoutingRule[]

PSApplicationGatewayRewriteRuleSet[]

PSApplicationGatewayRedirectConfiguration[]

PSApplicationGatewayWebApplicationFirewallConfiguration

PSApplicationGatewayAutoscaleConfiguration

Hashtable

PSManagedServiceIdentity

Outputs

PSApplicationGateway