Add-AzureRmApplicationGatewayRequestRoutingRule

NAME Add-AzureRmApplicationGatewayRequestRoutingRule



SYNOPSIS

Adds a request routing rule to an application gateway.





SYNTAX

Add-AzureRmApplicationGatewayRequestRoutingRule -ApplicationGateway <PSApplicationGateway> [-BackendAddressPool

<PSApplicationGatewayBackendAddressPool>] [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>] [-DefaultProfile

<IAzureContextContainer>] [-HttpListener <PSApplicationGatewayHttpListener>] -Name <String> [-RedirectConfiguration

<PSApplicationGatewayRedirectConfiguration>] -RuleType {Basic | PathBasedRouting} [-UrlPathMap <PSApplicationGatewayUrlPathMap>]

[<CommonParameters>]



Add-AzureRmApplicationGatewayRequestRoutingRule -ApplicationGateway <PSApplicationGateway> [-BackendAddressPoolId <String>]

[-BackendHttpSettingsId <String>] [-DefaultProfile <IAzureContextContainer>] [-HttpListenerId <String>] -Name <String> [-RedirectConfigurationId

<String>] -RuleType {Basic | PathBasedRouting} [-UrlPathMapId <String>] [<CommonParameters>]





DESCRIPTION

The Add-AzureRmApplicationGatewayRequestRoutingRule cmdlet adds a request routing rule to an application gateway.





PARAMETERS

-ApplicationGateway <PSApplicationGateway>

Specifies an application gateway to which this cmdlet adds a request routing rule.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-BackendAddressPool <PSApplicationGatewayBackendAddressPool>

Specifies an application gateway back-end address pool object.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-BackendAddressPoolId <String>

Specifies an application gateway back-end address pool ID.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>

Specifies a back-end HTTP settings object for an application gateway.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-BackendHttpSettingsId <String>

Specifies a backend HTTP settings ID for an application gateway.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-HttpListener <PSApplicationGatewayHttpListener>

Specifies application gateway HTTP listener object.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-HttpListenerId <String>

Specifies application gateway HTTP listener ID.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

Specifies the name of request routing rule this cmdlet adds.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>

Application gateway RedirectConfiguration



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-RedirectConfigurationId <String>

ID of the application gateway RedirectConfiguration



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-RuleType <String>

Specifies the type of request routing rule.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-UrlPathMap <PSApplicationGatewayUrlPathMap>





Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-UrlPathMapId <String>

Specifies the URL path map ID for the routing rule.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

System.String







OUTPUTS

Microsoft.Azure.Commands.Network.Models.PSApplicationGateway







NOTES









Example 1: Add a request routing rule to an application gateway



PS C:\\>$AppGw = Get-AzureRmApplicationGateway -Name "ApplicationGateway01" -ResourceGroupName "ResourceGroup01"

PS C:\\> $Appgw = Add-AzureApplicationGatewayRequestRoutingRule -ApplicationGateway $AppGw -Name "Rule01" -RuleType Basic -BackendHttpSettings

$Setting -HttpListener $Listener -BackendAddressPool $Pool



The first command gets the application gateway and stores it in the $AppGw variable. The second command adds the request routing rule to the

application gateway.







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... outingrule

Get-AzureRmApplicationGatewayRequestRoutingRule

New-AzureRmApplicationGatewayRequestRoutingRule

Remove-AzureRmApplicationGatewayRequestRoutingRule

Set-AzureRmApplicationGatewayRequestRoutingRule