New-AzureRmFirewallApplicationRuleCollection
Crea una raccolta di regole dell'applicazione firewall.
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-AzureRmFirewallApplicationRuleCollection
-Name <String>
-Priority <UInt32>
-Rule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSAzureFirewallApplicationRule]>
-ActionType <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Descrizione
Il cmdlet New-AzureRmFirewallApplicationRuleCollection crea una raccolta di regole applicazione del firewall.
Esempio
1: Creare una raccolta con una regola
$rule1 = New-AzureRmFirewallApplicationRule -Name "httpsRule" -Protocol "https:443" -TargetFqdn "*" -SourceAddress "10.0.0.0"
New-AzureRmFirewallApplicationRuleCollection -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.
2: Aggiungere una regola a una raccolta di regole
$rule1 = New-AzureRmFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzureRmFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$rule2 = New-AzureRmFirewallApplicationRule -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.
3: Ottenere una regola da una raccolta di regole
$rule1 = New-AzureRmFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzureRmFirewallApplicationRuleCollection -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.
4: Rimuovere una regola da una raccolta di regole
$rule1 = New-AzureRmFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$rule2 = New-AzureRmFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com"
$ruleCollection = New-AzureRmFirewallApplicationRuleCollection -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
Tipo: | String |
Valori accettati: | Allow, Deny |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-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 |
-Name
Specifica il nome della regola dell'applicazione. Il nome deve essere univoco all'interno di una raccolta regole.
Tipo: | String |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Priority
Specifica la priorità di questa regola. La priorità è un numero compreso tra 100 e 65000. Minore è il numero, maggiore è la priorità.
Tipo: | UInt32 |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Rule
Specifica l'elenco di regole da raggruppare in questa raccolta.
Tipo: | List<T>[PSAzureFirewallApplicationRule] |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | True |
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
Questo cmdlet non accetta alcun input.
Output
Microsoft.Azure.Commands.Network.Models.PSFirewallApplicationRuleCollection