New-AzApplicationGateway
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]
[-EnableResponseBuffering]
[-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]
[-ForceFirewallPolicyAssociation]
[-Zone <String[]>]
[-Tag <Hashtable>]
[-Force]
[-EnableRequestBuffering]
[-EnableResponseBuffering]
[-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]
[-EnableResponseBuffering]
[-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]
[-EnableResponseBuffering]
[-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).
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 $SkuThe 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 $SkuParameters
-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: | Boolean |
| Position: | Named |
| Default value: | True |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableResponseBuffering
Whether Response Buffering is enabled.
| Type: | 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
PSApplicationGatewayIPConfiguration[]
PSApplicationGatewaySslCertificate[]
PSApplicationGatewayAuthenticationCertificate[]
PSApplicationGatewayTrustedRootCertificate[]
PSApplicationGatewayFrontendIPConfiguration[]
PSApplicationGatewayFrontendPort[]
PSApplicationGatewayBackendAddressPool[]
PSApplicationGatewayBackendHttpSettings[]
PSApplicationGatewayHttpListener[]
PSApplicationGatewayUrlPathMap[]
PSApplicationGatewayRequestRoutingRule[]
PSApplicationGatewayRewriteRuleSet[]
PSApplicationGatewayRedirectConfiguration[]
PSApplicationGatewayWebApplicationFirewallConfiguration
PSApplicationGatewayAutoscaleConfiguration
Outputs
Related Links
- New-AzApplicationGatewayBackendAddressPool
- New-AzApplicationGatewayBackendHttpSetting
- New-AzApplicationGatewayFrontendIPConfig
- New-AzApplicationGatewayFrontendPort
- New-AzApplicationGatewayHttpListener
- New-AzApplicationGatewayIPConfiguration
- New-AzApplicationGatewayRequestRoutingRule
- New-AzApplicationGatewaySku
- New-AzVirtualNetwork
- New-AzVirtualNetworkSubnetConfig
Collaborate with us on GitHub
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
Azure PowerShell
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for