New-AzureRmFirewallNetworkRuleCollection
Crea una Firewall di Azure raccolta di reti di regole di rete.
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-AzureRmFirewallNetworkRuleCollection
-Name <String>
-Priority <UInt32>
-Rule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSAzureFirewallNetworkRule]>
-ActionType <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Descrizione
Il cmdlet New-AzureRmFirewallNetworkRuleCollection crea una raccolta di regole di rete del firewall.
Esempio
1: Creare una raccolta di rete con due regole
$rule1 = New-AzureRmFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol UDP -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$rule2 = New-AzureRmFirewallNetworkRule -Name "partial-tcp-rule" -Description "Rule for all TCP traffic from 10.0.0.0 to 60.1.5.0:4040" -Protocol TCP -SourceAddress "10.0.0.0" -DestinationAddress "60.1.5.0" -DestinationPort "4040"
New-AzureRmFirewallNetworkRuleCollection -Name RC1 -Priority 100 -Rule $rule1, $rule2 -ActionType "Allow"In questo esempio viene creata una raccolta che consentirà tutto il traffico corrispondente a una delle due regole. La prima regola è per tutto il traffico UDP. La seconda regola riguarda il traffico TCP da 10.0.0.0 a 60.1.5.0:4040. Se è presente un'altra raccolta di regole di rete con priorità più alta (numero minore) che corrisponde anche al traffico identificato in $rule 1 o $rule 2, l'azione della raccolta regole con priorità più alta avrà invece effetto.
2: Aggiungere una regola a una raccolta di regole
$rule1 = New-AzureRmFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol UDP -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$ruleCollection = New-AzureRmFirewallNetworkRuleCollection -Name "MyNetworkRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$rule2 = New-AzureRmFirewallNetworkRule -Name "partial-tcp-rule" -Description "Rule for all TCP traffic from 10.0.0.0 to 60.1.5.0:4040" -Protocol TCP -SourceAddress "10.0.0.0" -DestinationAddress "60.1.5.0" -DestinationPort "4040"
$ruleCollection.AddRule($rule2)In questo esempio viene creata una nuova raccolta di regole di rete con una regola e quindi viene aggiunta una seconda regola alla raccolta 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-AzureRmFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol UDP -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$ruleCollection = New-AzureRmFirewallNetworkRuleCollection -Name "MyNetworkRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$getRule=$ruleCollection.GetRuleByName("ALL-UDP-traffic")Questo esempio crea una nuova raccolta regole di rete 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-AzureRmFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol UDP -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$rule2 = New-AzureRmFirewallNetworkRule -Name "partial-tcp-rule" -Description "Rule for all TCP traffic from 10.0.0.0 to 60.1.5.0:4040" -Protocol TCP -SourceAddress "10.0.0.0" -DestinationAddress "60.1.5.0" -DestinationPort "4040"
$ruleCollection = New-AzureRmFirewallNetworkRuleCollection -Name "MyNetworkRuleCollection" -Priority 100 -Rule $rule1, $rule2 -ActionType "Allow"
$ruleCollection.RemoveRuleByName("ALL-udp-traffic")In questo esempio viene creata una nuova raccolta di regole di rete con due regole e quindi viene rimossa 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
Specifica l'azione da eseguire per le condizioni di corrispondenza del traffico di questa regola. Le azioni accettate sono "Consenti" o "Nega".
| 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: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifica il nome di questa raccolta di regole di rete. Il nome deve essere univoco in tutta la raccolta di regole di rete.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Priority
Specifica la priorità di questa raccolta di regole. La priorità è un numero compreso tra 100 e 65000. Più piccolo è il numero, più alta è 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: | List<T>[PSAzureFirewallNetworkRule] |
| 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
Questo cmdlet non accetta alcun input.
Output
Microsoft.Azure.Commands.Network.Models.PSFirewallNetworkRuleCollection