Set-AzApplicationGatewayUrlPathMapConfig
Sets configuration for an array of URL path mappings to a backend server pool.
Syntax
BackendSetByResource (Default)
Set-AzApplicationGatewayUrlPathMapConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
-PathRules <PSApplicationGatewayPathRule[]>
-DefaultBackendAddressPool <PSApplicationGatewayBackendAddressPool>
-DefaultBackendHttpSettings <PSApplicationGatewayBackendHttpSettings>
[-DefaultRewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
BackendSetByResourceId
Set-AzApplicationGatewayUrlPathMapConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
-PathRules <PSApplicationGatewayPathRule[]>
-DefaultBackendAddressPoolId <String>
-DefaultBackendHttpSettingsId <String>
[-DefaultRewriteRuleSetId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
RedirectSetByResource
Set-AzApplicationGatewayUrlPathMapConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
-PathRules <PSApplicationGatewayPathRule[]>
-DefaultRedirectConfiguration <PSApplicationGatewayRedirectConfiguration>
[-DefaultRewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
RedirectSetByResourceId
Set-AzApplicationGatewayUrlPathMapConfig
-ApplicationGateway <PSApplicationGateway>
-Name <String>
-PathRules <PSApplicationGatewayPathRule[]>
-DefaultRedirectConfigurationId <String>
[-DefaultRewriteRuleSetId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
The Set-AzApplicationGatewayUrlPathMapConfig cmdlet sets configuration for an array of URL path mappings to a backend server pool.
Examples
Example 1: Update an URL path mapping
$appgw = Get-AzApplicationGateway -ResourceGroupName "rg" -Name "appGwName"
$appgw = Set-AzApplicationGatewayUrlPathMapConfig -ApplicationGateway $appgw -Name "map01"
$appgw = Set-AzApplicationGateway -ApplicationGateway $appgw
The first command gets the application gateway named appGwName and stores the result in the $appgw variable.
The second command updates the URL path mapping named map01 in the application gateway.
The third command updates the application gateway.
Parameters
-ApplicationGateway
Specifies the application gateway to which this cmdlet sets a URL path map configuration.
Parameter properties
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: True Value from pipeline by property name: False Value from remaining arguments: False
-DefaultBackendAddressPool
Specifies the default backend address pool to route in case none of the rules specified in the pathRules parameter match.
Parameter properties
Parameter sets
BackendSetByResource
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultBackendAddressPoolId
Specifies the default backend address pool ID.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
BackendSetByResourceId
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultBackendHttpSettings
Specifies the default backend HTTP settings to use in case none of the rules specified in the pathRules parameter match.
Parameter properties
Parameter sets
BackendSetByResource
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultBackendHttpSettingsId
Specifies the default backend HTTP settings ID.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
BackendSetByResourceId
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultProfile
The credentials, account, tenant, and subscription used for communication with azure.
Parameter properties
Type: IAzureContextContainer
Default value: None Supports wildcards: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultRedirectConfiguration
Application gateway default RedirectConfiguration
Parameter properties
Parameter sets
RedirectSetByResource
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultRedirectConfigurationId
ID of the application gateway default RedirectConfiguration
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
RedirectSetByResourceId
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultRewriteRuleSet
Application gateway default rewrite rule set
Parameter properties
Parameter sets
BackendSetByResource
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
RedirectSetByResource
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultRewriteRuleSetId
ID of the application gateway default rewrite rule set
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
BackendSetByResourceId
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
RedirectSetByResourceId
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-Name
Specifies the URL path map name in which this cmdlet sets configuration for.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-PathRules
Specifies a list of path rules.
Note that the path rules are order sensitive, they are applied in order they are specified.
Parameter properties
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters .
Outputs
