Set-AzureRmApplicationGatewayRequestRoutingRule

NAME Set-AzureRmApplicationGatewayRequestRoutingRule



SYNOPSIS

Modifies a request routing rule for an application gateway.





SYNTAX

Set-AzureRmApplicationGatewayRequestRoutingRule -ApplicationGateway <PSApplicationGateway> [-BackendAddressPool

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

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

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

[<CommonParameters>]



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

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

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





DESCRIPTION

The Set-AzureRmApplicationGatewayRequestRoutingRule cmdlet modifies a request routing rule.





PARAMETERS

-ApplicationGateway <PSApplicationGateway>

Specifies the application gateway object with which this cmdlet associates a request routing rule.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-BackendAddressPool <PSApplicationGatewayBackendAddressPool>

Specifies the application gateway back-end address pool.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-BackendAddressPoolId <String>

Specifies the 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 the application gateway backend HTTP settings.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-BackendHttpSettingsId <String>

Specifies the application gateway back-end HTTP settings ID.



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 the application gateway HTTP listener.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-HttpListenerId <String>

Specifies the 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 the request routing rule that this cmdlet modifies.



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>





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: Update a request routing rule



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

PS C:\\> $AppGw = Set-AzureRmApplicationGatewayRequestRoutingRule -ApplicationGateway $AppGw -Name "Rule01" -RuleType Basic -BackendHttpSettings

$Setting -HttpListener $Listener -BackendAddressPool $Pool



The first command gets the application gateway named ApplicationGateway01 and stores it in the $AppGw variable.



The second command modifies the request routing rule for the application gateway to use back-end HTTP settings specified in the $Setting variable,

an HTTP listener specified in the $Listener variable, and a back-end address pool specified in the $Pool variable.







RELATED LINKS

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

Add-AzureRmApplicationGatewayRequestRoutingRule

Get-AzureRmApplicationGatewayRequestRoutingRule

New-AzureRmApplicationGatewayRequestRoutingRule

Remove-AzureRmApplicationGatewayRequestRoutingRule