共用方式為


New-AzApplicationGatewayFirewallCustomRule

為應用程式閘道防火牆原則建立新的自訂規則。

語法

Default (預設值)

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 會建立防火牆原則的自訂規則。

範例

範例 1

New-AzApplicationGatewayFirewallCustomRule -Name example-rule -Priority 1 -RuleType MatchRule -MatchCondition $condition -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
                        }
                      ]

此命令會建立名稱為 example-rule、優先順序 1 的新自訂規則,且規則類型會是 MatchRule,條件變數中定義條件,動作會允許。

範例 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
                        }
                      ]

此命令會建立名稱為 example-rule、狀態為 Disabled、優先順序為 2 的新自訂規則,且規則型別將是 MatchRule,條件變數中定義了條件,則動作將允許。

範例 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"
                            }
                          ]
                        }
                      ]

此命令會建立名稱為 RateLimitRule3、狀態為 Disabled、優先順序為 3、RateLimitDuration OneMin、RateLimitThreshold 為 10 的新自訂規則,且規則類型會是 RateLimitRule,條件變數中定義的條件,動作會允許 GroupByUserSession 條件變數中定義的 GroupByUserSession。

參數

-Action

動作的類型。

參數屬性

類型:String
預設值:None
接受的值:Allow, Block, Log
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-GroupByUserSession

比對條件的清單。

參數屬性

類型:

PSApplicationGatewayFirewallCustomRuleGroupByUserSession[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MatchCondition

比對條件的清單。

參數屬性

類型:

PSApplicationGatewayFirewallCondition[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

規則的名稱。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Priority

描述規則的優先順序。 在具有較高值的規則之前,將會先評估具有較低值的規則。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RateLimitDuration

描述將套用速率限制原則的持續時間。 僅適用於 ruleType 為 RateLimitRule 時。

參數屬性

類型:String
預設值:None
接受的值:OneMin, FiveMins
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RateLimitThreshold

描述速率限制閾值。 只有在 ruleType 為 RateLimitRule 時才適用。此值的接受範圍為 1 - 5000。

參數屬性

類型:Int32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-RuleType

描述規則的類型。

參數屬性

類型:String
預設值:None
接受的值:MatchRule, RateLimitRule
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-State

自訂規則的狀態變數。

參數屬性

類型:String
預設值:Enabled
接受的值:Disabled, Enabled
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

None

輸出

PSApplicationGatewayFirewallCustomRule