New-AzureRmApplicationGatewayRequestRoutingRule

NAME New-AzureRmApplicationGatewayRequestRoutingRule



SYNOPSIS

Creates a request routing rule for an application gateway.





SYNTAX

New-AzureRmApplicationGatewayRequestRoutingRule [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>] [-BackendHttpSettings

<PSApplicationGatewayBackendHttpSettings>] [-DefaultProfile <IAzureContextContainer>] [-HttpListener <PSApplicationGatewayHttpListener>] -Name

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

<PSApplicationGatewayUrlPathMap>] [<CommonParameters>]



New-AzureRmApplicationGatewayRequestRoutingRule [-BackendAddressPoolId <String>] [-BackendHttpSettingsId <String>] [-DefaultProfile

<IAzureContextContainer>] [-HttpListenerId <String>] -Name <String> [-RedirectConfigurationId <String>] -RuleType {Basic | PathBasedRouting}

[-UrlPathMapId <String>] [<CommonParameters>]





DESCRIPTION

The Add-AzureRmApplicationGatewayRequestRoutingRule cmdlet creates a request routing rule for an Azure application gateway.





PARAMETERS

-BackendAddressPool <PSApplicationGatewayBackendAddressPool>

Specifies the back-end address pool, as an object, for the request routing rule to create.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-BackendAddressPoolId <String>

Specifies the back-end address pool ID of the request routing rule to create.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>

Specifies the back-end HTTP settings, as an object, for the request routing rule to create.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-BackendHttpSettingsId <String>

Specifies the back-end HTTP settings ID of the request routing rule to create.



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 back-end HTTP listener for the request routing rule to create.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-HttpListenerId <String>

Specifies the backend HTTP listener ID for the request routing rule to create.



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 creates.



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 type of the 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.PSApplicationGatewayRequestRoutingRule







NOTES









Example 1: Create a request routing rule for an application gateway



PS C:\\>$Rule = New-AzureRmApplicationGatewayRequestRoutingRule -Name "Rule01" -RuleType Basic -BackendHttpSettings $Setting -HttpListener

$Listener -BackendAddressPool $Pool



This command creates a basic request routing rule named Rule01 and stores the result in the variable named $Rule.







RELATED LINKS

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

Add-AzureRmApplicationGatewayRequestRoutingRule

Get-AzureRmApplicationGatewayRequestRoutingRule

Remove-AzureRmApplicationGatewayRequestRoutingRule

Set-AzureRmApplicationGatewayRequestRoutingRule