New-AzApplicationGatewayFirewallCustomRule

Modul:

Az.Network

Skapar en ny anpassad regel för brandväggsprincipen för application gateway.

Syntax

New-AzApplicationGatewayFirewallCustomRule
   -Name <String>
   -Priority <Int32>
   [-RateLimitDuration <String>]
   [-RateLimitThreshold <Int32>]
   -RuleType <String>
   -MatchCondition <PSApplicationGatewayFirewallCondition[]>
   [-GroupByUserSession <PSApplicationGatewayFirewallCustomRuleGroupByUserSession[]>]
   -Action <String>
   [-State <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

New-AzApplicationGatewayFirewallCustomRule skapar en anpassad regel för brandväggsprincipen.

Exempel

Exempel 1

New-AzApplicationGatewayFirewallCustomRule -Name example-rule -Priority 1 -RuleType MatchRule -MatchCondition $condtion -Action Allow

Name                : example-rule
Priority            : 1
RuleType            : MatchRule
MatchConditions     : {Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFirewallCondition}
Action              : Allow
State               : Enabled
MatchConditionsText : [
                        {
                          "MatchVariables": [
                            {
                              "VariableName": "RequestHeaders",
                              "Selector": "Malicious-Header"
                            }
                          ],
                          "OperatorProperty": "Any",
                          "NegationConditon": false
                        }
                      ]

Kommandot skapar en ny anpassad regel med namnet på exempelregeln, prioritet 1 och regeltypen är MatchRule med villkoret definierat i villkorsvariabeln, åtgärden tillåter.

Exempel 2

New-AzApplicationGatewayFirewallCustomRule -Name example-rule -Priority 2 -RuleType MatchRule -MatchCondition $condition -Action Allow -State Disabled

Name                : example-rule
Priority            : 2
RuleType            : MatchRule
MatchConditions     : {Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFirewallCondition}
Action              : Allow
State               : Disabled
MatchConditionsText : [
                        {
                          "MatchVariables": [
                            {
                              "VariableName": "RequestHeaders",
                              "Selector": "Malicious-Header"
                            }
                          ],
                          "OperatorProperty": "Any",
                          "NegationConditon": false
                        }
                      ]

Kommandot skapar en ny anpassad regel med namnet på exempelregeln, tillstånd som Inaktiverad, prioritet 2 och regeltypen kommer att vara MatchRule med villkoret definierat i villkorsvariabeln, åtgärden tillåter.

Exempel 3

New-AzApplicationGatewayFirewallCustomRule -Name RateLimitRule3 -Priority 3 -RateLimitDuration OneMin -RateLimitThreshold 10 -RuleType RateLimitRule -MatchCondition $condition -GroupByUserSession $groupbyUserSes -Action Allow -State Disabled

Name                : RateLimitRule3
Priority            : 3
RateLimitDuration   : OneMin
RateLimitThreshold  : 10
RuleType            : RateLimitRule
MatchConditions     : {Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFirewallCondition}
GroupByUserSession  : {Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFirewallCustomRuleGroupByUserSession}
Action              : Allow
State               : Disabled
MatchConditionsText : [
                        {
                          "MatchVariables": [
                            {
                              "VariableName": "RequestHeaders",
                              "Selector": "Malicious-Header"
                            }
                          ],
                          "OperatorProperty": "Any",
                          "NegationConditon": false
                        }
                      ]
GroupByUserSessionText : [
                        {
                          "groupByVariables": [
                            {
                              "variableName": "ClientAddr"
                            }
                          ]
                        }
                      ]

Kommandot skapar en ny anpassad regel med namnet RateLimitRule3, tillstånd som Inaktiverad, prioritet 3, RateLimitDuration OneMin, RateLimitThreshold 10 och regeltypen är RateLimitRule med villkoret definierat i villkorsvariabeln, åtgärden tillåter, GroupByUserSession definieras i villkorsvariabeln GroupByUserSession.

Parametrar

-Action

Typ av åtgärder.

Typ:	String
Godkända värden:	Allow, Block, Log
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-GroupByUserSession

Lista över matchningsvillkor.

Typ:	PSApplicationGatewayFirewallCustomRuleGroupByUserSession[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-MatchCondition

Lista över matchningsvillkor.

Typ:	PSApplicationGatewayFirewallCondition[]
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Name

Regelns namn.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Priority

Beskriver regelns prioritet. Regler med ett lägre värde utvärderas före regler med ett högre värde.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RateLimitDuration

Beskriver varaktigheten för vilken princip för hastighetsbegränsning som ska tillämpas. Gäller endast när ruleType är RateLimitRule.

Typ:	String
Godkända värden:	OneMin, FiveMins
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RateLimitThreshold

Beskriver tröskelvärdet för hastighetsbegränsning. Gäller endast när ruleType är RateLimitRule.Accepted-intervallet för det här värdet är 1–5 000.

Typ:	Int32
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RuleType

Beskriver typ av regel.

Typ:	String
Godkända värden:	MatchRule, RateLimitRule
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-State

Tillståndsvariabel för den anpassade regeln.

Typ:	String
Godkända värden:	Disabled, Enabled
Position:	Named
Standardvärde:	Enabled
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

None

Utdata

PSApplicationGatewayFirewallCustomRule