New-AzFirewallApplicationRuleCollection

  • Riferimento
Modulo:
Az.Network

Crea una raccolta di regole dell'applicazione firewall.

Sintassi

New-AzFirewallApplicationRuleCollection
   -Name <String>
   -Priority <UInt32>
   -Rule <PSAzureFirewallApplicationRule[]>
   -ActionType <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet New-AzFirewallApplicationRuleCollection crea una raccolta di regole applicazione del firewall.

Esempio

Esempio 1: Creare una raccolta con una regola

$rule1 = New-AzFirewallApplicationRule -Name "httpsRule" -Protocol "https:443" -TargetFqdn "*" -SourceAddress "10.0.0.0"
New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 1000 -Rule $rule1 -ActionType "Allow"

In questo esempio viene creata una raccolta con una regola. Tutto il traffico che corrisponde alle condizioni identificate in $rule 1 sarà consentito. La prima regola riguarda tutto il traffico HTTPS sulla porta 443 dalla versione 10.0.0.0. Se è presente un'altra raccolta di regole dell'applicazione con priorità più alta (numero minore) che corrisponde anche al traffico identificato in $rule 1, l'azione della raccolta regole con priorità più alta avrà invece effetto.

Esempio 2: Aggiungere una regola a una raccolta regole

$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"

$rule2 = New-AzFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" 
$ruleCollection.AddRule($rule2)

In questo esempio viene creata una nuova raccolta di regole dell'applicazione con una regola e quindi viene aggiunta una seconda regola all'insieme di regole usando il metodo AddRule nell'oggetto raccolta regole. Ogni nome di regola in una determinata raccolta regole deve avere un nome univoco e non fa distinzione tra maiuscole e minuscole.

Esempio 3: Ottenere una regola da una raccolta regole

$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$getRule=$ruleCollection.GetRuleByName("r1")

Questo esempio crea una nuova raccolta di regole dell'applicazione con una regola e quindi ottiene la regola in base al nome, chiamando il metodo GetRuleByName nell'oggetto raccolta regole. Il nome della regola per il metodo GetRuleByName non fa distinzione tra maiuscole e minuscole.

Esempio 4: Rimuovere una regola da una raccolta regole

$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$rule2 = New-AzFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" 
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1, $rule1 -ActionType "Allow"
$ruleCollection.RemoveRuleByName("r1")

Questo esempio crea una nuova raccolta di regole dell'applicazione con due regole e quindi rimuove la prima regola dalla raccolta regole chiamando il metodo RemoveRuleByName nell'oggetto raccolta regole. Il nome della regola per il metodo RemoveRuleByName non fa distinzione tra maiuscole e minuscole.

Parametri

-ActionType

Azione della raccolta di regole

Type:String
Accepted values:Allow, Deny
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica il nome della regola dell'applicazione. Il nome deve essere univoco all'interno di una raccolta regole.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Priority

Specifica la priorità di questa regola. La priorità è un numero compreso tra 100 e 65000. Minore è il numero, maggiore è la priorità.

Type:UInt32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Rule

Specifica l'elenco di regole da raggruppare in questa raccolta.

Type:PSAzureFirewallApplicationRule[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

PSAzureFirewallApplicationRuleCollection