Condividi tramite

New-AzureRmApplicationGatewayWebApplicationFirewallConfiguration

  • Riferimento
Modulo:
AzureRM.Network

Crea una configurazione di WAF per un gateway applicazione.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

New-AzureRmApplicationGatewayWebApplicationFirewallConfiguration
   -Enabled <Boolean>
   -FirewallMode <String>
   [-RuleSetType <String>]
   [-RuleSetVersion <String>]
   [-DisabledRuleGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFirewallDisabledRuleGroup]>]
   [-RequestBodyCheck <Boolean>]
   [-MaxRequestBodySizeInKb <Int32>]
   [-FileUploadLimitInMb <Int32>]
   [-Exclusion <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayFirewallExclusion]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzureRmApplicationGatewayWebApplicationFirewallConfiguration crea una configurazione web application firewall (WAF) per un gateway applicazione di Azure.

Esempio

Esempio 1: Creare una configurazione web application firewall per un gateway applicazione

PS C:\> $disabledRuleGroup1 = New-AzureRmApplicationGatewayFirewallDisabledRuleGroupConfig -RuleGroupName "REQUEST-942-APPLICATION-ATTACK-SQLI" -Rules 942130,942140
PS C:\> $disabledRuleGroup2 = New-AzureRmApplicationGatewayFirewallDisabledRuleGroupConfig -RuleGroupName "REQUEST-921-PROTOCOL-ATTACK"
PS C:\> $firewallConfig = New-AzureRmApplicationGatewayWebApplicationFirewallConfiguration -Enabled $true -FirewallMode "Prevention" -RuleSetType "OWASP" -RuleSetVersion "3.0" -DisabledRuleGroups $disabledRuleGroup1,$disabledRuleGroup2

Il primo comando crea una nuova configurazione del gruppo di regole disabilitata per il gruppo di regole denominato "REQUEST-942-APPLICATION-ATTACK-SQLI" con regola 942130 e regola 942140 disabilitata. Il secondo comando crea un'altra configurazione del gruppo di regole disabilitata per un gruppo di regole denominato "REQUEST-921-PROTOCOL-ATTACK". Nessuna regola viene passata in modo specifico e pertanto tutte le regole del gruppo di regole verranno disabilitate. L'ultimo comando crea quindi una configurazione WAF con regole del firewall disabilitate come configurato in $disabledRuleGroup 1 e $disabledRuleGroup 2. La nuova configurazione waf viene archiviata nella variabile $firewallConfig.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisabledRuleGroup

Gruppi di regole disabilitati.

Tipo:List<T>[PSApplicationGatewayFirewallDisabledRuleGroup]
Alias:DisabledRuleGroups
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Enabled

Indica se WAF è abilitato.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Exclusion

Elenchi di esclusione.

Tipo:List<T>[PSApplicationGatewayFirewallExclusion]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FileUploadLimitInMb

Limite massimo di caricamento file in MB.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FirewallMode

Specifica la modalità web application firewall. I valori validi per questo parametro sono:

  • Rilevamento
  • Prevenzione
Tipo:String
Valori accettati:Detection, Prevention
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaxRequestBodySizeInKb

Dimensioni massime del corpo della richiesta in KB.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RequestBodyCheck

Indica se il corpo della richiesta è selezionato o meno.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RuleSetType

Tipo di set di regole web application firewall. I valori validi per questo parametro sono:

  • OWASP
Tipo:String
Valori accettati:OWASP
Posizione:Named
Valore predefinito:OWASP
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RuleSetVersion

Versione del tipo di set di regole. I valori validi per questo parametro sono:

  • 3.0
  • 2.2.9
Tipo:String
Valori accettati:3.0, 2.2.9
Posizione:Named
Valore predefinito:3.0
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

PSApplicationGatewayWebApplicationFirewallConfiguration