Dela via


New-AzureRmFirewallNetworkRuleCollection

Skapar en Azure Firewall-nätverkssamling med nätverksregler.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Description

Cmdleten New-AzureRmFirewallNetworkRuleCollection skapar en samling brandväggsnätverksregler.

Exempel

1: Skapa en nätverkssamling med två regler

$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"

Det här exemplet skapar en samling som tillåter all trafik som matchar någon av de två reglerna. Den första regeln gäller för all UDP-trafik. Den andra regeln gäller för TCP-trafik från 10.0.0.0 till 60.1.5.0:4040. Om det finns en annan nätverksregelsamling med högre prioritet (mindre nummer) som också matchar trafik som identifieras i $rule 1 eller $rule 2, tillämpas åtgärden för regelsamlingen med högre prioritet i stället.

2: Lägga till en regel i en regelsamling

$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)

Det här exemplet skapar en ny nätverksregelsamling med en regel och lägger sedan till en andra regel i regelsamlingen med metoden AddRule i regelsamlingsobjektet. Varje regelnamn i en viss regelsamling måste ha ett unikt namn och är skiftlägesokänsligt.

3: Hämta en regel från en regelsamling

$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")

Det här exemplet skapar en ny nätverksregelsamling med en regel och hämtar sedan regeln efter namn och anropar metoden GetRuleByName på regelsamlingsobjektet. Regelnamnet för metoden GetRuleByName är skiftlägeskänsligt.

4: Ta bort en regel från en regelsamling

$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")

Det här exemplet skapar en ny nätverksregelsamling med två regler och tar sedan bort den första regeln från regelsamlingen genom att anropa metoden RemoveRuleByName på regelsamlingsobjektet. Regelnamnet för metoden RemoveRuleByName är skiftlägeskänsligt.

Parametrar

-ActionType

Anger vilken åtgärd som ska vidtas för trafikmatchningsvillkor för den här regeln. Godkända åtgärder är "Tillåt" eller "Neka".

Typ:String
Godkända värden:Allow, Deny
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på den här nätverksregelsamlingen. Namnet måste vara unikt för alla nätverksregelsamlingar.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Priority

Anger prioriteten för den här regelsamlingen. Prioritet är ett tal mellan 100 och 65000. Ju mindre tal, desto högre prioritet.

Typ:UInt32
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Rule

Anger listan över regler som ska grupperas under den här samlingen.

Typ:List<T>[PSAzureFirewallNetworkRule]
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Den här cmdleten accepterar inga indata.

Utdata

Microsoft.Azure.Commands.Network.Models.PSFirewallNetworkRuleCollection