New-AzApplicationGatewayHeaderValueMatcher
Creates a HeaderValueMatcher object configuration to use in ApplicationGatewayRewriteRuleHeaderConfiguration for an application gateway.
Syntax
Default (Default)
New-AzApplicationGatewayHeaderValueMatcher
-Pattern <String>
[-IgnoreCase]
[-Negate]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
The New-AzApplicationGatewayHeaderValueMatcher cmdlet creates a Header Value Matcher object for an Azure application gateway.
Examples
Example 1
$hvm = New-AzApplicationGatewayHeaderValueMatcher -Pattern ".*" -IgnoreCase -Negate
$requestHeaderConfiguration01 = New-AzApplicationGatewayRewriteRuleHeaderConfiguration -HeaderName "Set-Cookie" -HeaderValue "val" -HeaderValueMatcher $headerValueMatcher
This command creates a HeaderValueMatcher configuration and stores the result in the variable named $hvm and then use it in a ApplicationGatewayRewriteRuleHeaderConfiguration object.
Parameters
-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 |
-IgnoreCase
Set this flag to ignore during pattern matching
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Negate
Set this flag to negate the result of pattern matching against a header value
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Pattern
Pattern to look for in the header values
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 |
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
PSApplicationGatewayHeaderValueMatcher
Related Links
- New-AzApplicationGatewayRewriteRuleHeaderConfiguration
- Add-AzApplicationGatewayRewriteRuleSet
- Get-AzApplicationGatewayRewriteRuleSet
- New-AzApplicationGatewayRewriteRuleSet
- Remove-AzApplicationGatewayRewriteRuleSet
- Set-AzApplicationGatewayRewriteRuleSet
- New-AzApplicationGatewayRewriteRule
- New-AzApplicationGatewayRewriteRuleActionSet
- Rewrite HTTP headers and URL with Application Gateway