Partilhar via

New-AzApplicationGatewayFirewallCustomRule

Módulo:
Az.Network Module

Cria uma nova regra personalizada para a diretiva de firewall do gateway de aplicativo.

Sintaxe

Default (Predefinição) 

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

Description

O New-AzApplicationGatewayFirewallCustomRule cria uma regra personalizada para a política de firewall.

Exemplos

Exemplo 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
                        }
                      ]

O comando cria uma nova regra personalizada com nome de exemplo-regra, prioridade 1 e o tipo de regra será MatchRule com condição definida na variável de condição, a ação será a permissão.

Exemplo 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
                        }
                      ]

O comando cria uma nova regra personalizada com nome de exemplo-regra, estado como Desativado, prioridade 2 e o tipo de regra será MatchRule com condição definida na variável de condição, a ação será a permissão.

Exemplo 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"
                            }
                          ]
                        }
                      ]

O comando cria uma nova regra personalizada com o nome de RateLimitRule3, estado como Disabled, prioridade 3, RateLimitDuration OneMin, RateLimitThreshold 10 e o tipo de regra será RateLimitRule com condição definida na variável de condição, a ação será a allow, o GroupByUserSession definido na variável de condição GroupByUserSession.

Parâmetros

-Action

Tipo de Ações.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:Allow, Block, Log
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-GroupByUserSession

Lista de condições de jogo.

Propriedades dos parâmetros

Tipo:

PSApplicationGatewayFirewallCustomRuleGroupByUserSession[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-MatchCondition

Lista de condições de jogo.

Propriedades dos parâmetros

Tipo:

PSApplicationGatewayFirewallCondition[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

O nome da regra.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Priority

Descreve a prioridade da regra. As regras com um valor mais baixo serão avaliadas antes das regras com um valor mais elevado.

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RateLimitDuration

Descreve a duração durante a qual a política de Limite de Taxa será aplicada. Aplica-se somente quando ruleType é RateLimitRule.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:OneMin, FiveMins
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RateLimitThreshold

Descreve o limite de taxa. Aplica-se somente quando ruleType é RateLimitRule.O intervalo aceito para esse valor é 1 - 5000.

Propriedades dos parâmetros

Tipo:Int32
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RuleType

Descreve o tipo de regra.

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:MatchRule, RateLimitRule
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-State

Variável de estado da regra personalizada.

Propriedades dos parâmetros

Tipo:String
Default value:Enabled
Valores aceites:Disabled, Enabled
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

PSApplicationGatewayFirewallCustomRule