New-AzApplicationGatewayUrlPathMapConfig
Creates an array of URL path mappings to a backend server pool.
Syntax
BackendSetByResource (Default)
New-AzApplicationGatewayUrlPathMapConfig
-Name <String>
-PathRules <PSApplicationGatewayPathRule[]>
-DefaultBackendAddressPool <PSApplicationGatewayBackendAddressPool>
-DefaultBackendHttpSettings <PSApplicationGatewayBackendHttpSettings>
[-DefaultRewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
BackendSetByResourceId
New-AzApplicationGatewayUrlPathMapConfig
-Name <String>
-PathRules <PSApplicationGatewayPathRule[]>
-DefaultBackendAddressPoolId <String>
-DefaultBackendHttpSettingsId <String>
[-DefaultRewriteRuleSetId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
RedirectSetByResource
New-AzApplicationGatewayUrlPathMapConfig
-Name <String>
-PathRules <PSApplicationGatewayPathRule[]>
-DefaultRedirectConfiguration <PSApplicationGatewayRedirectConfiguration>
[-DefaultRewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
RedirectSetByResourceId
New-AzApplicationGatewayUrlPathMapConfig
-Name <String>
-PathRules <PSApplicationGatewayPathRule[]>
-DefaultRedirectConfigurationId <String>
[-DefaultRewriteRuleSetId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
The New-AzApplicationGatewayUrlPathMapConfig cmdlet creates an array of URL path mappings to a backend server pool.
Examples
Example 1: Create an array of URL path mappings to a backend server pool
New-AzApplicationGatewayUrlPathMapConfig -Name $UrlPathMapName -PathRules $VideoPathRule, $ImagePathRule -DefaultBackendAddressPool $Pool -DefaultBackendHttpSettings $PoolSetting02
This command creates an array of URL path mappings to a backend server pool.
Parameters
-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 that this cmdlet creates.
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 .
None
Outputs