Edit

Share via


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

Type:PSApplicationGatewayBackendAddressPool
Default value:None
Supports wildcards:False
DontShow:False

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

Type:PSApplicationGatewayBackendHttpSettings
Default value:None
Supports wildcards:False
DontShow:False

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

Type:PSApplicationGatewayRedirectConfiguration
Default value:None
Supports wildcards:False
DontShow:False

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

Type:PSApplicationGatewayRewriteRuleSet
Default value:None
Supports wildcards:False
DontShow:False

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

Type:

PSApplicationGatewayPathRule[]

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

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.

Inputs

None

Outputs

PSApplicationGatewayUrlPathMap