Freigeben über


New-AzFirewallNatRuleCollection

Erstellt eine Auflistung von Firewall-NAT-Regeln.

Syntax

Default (Standard)

New-AzFirewallNatRuleCollection
    -Name <String>
    -Priority <UInt32>
    -Rule <PSAzureFirewallNatRule[]>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzFirewallNatRuleCollection erstellt eine Sammlung von Firewall-NAT-Regeln.

Beispiele

Beispiel 1: Erstellen einer Auflistung mit einer Regel

$rule1 = New-AzFirewallNatRule -Name "natRule" -Protocol "TCP" -SourceAddress "*" -DestinationAddress "10.0.0.1" -DestinationPort "80" -TranslatedAddress "10.0.0.2" -TranslatedPort "8080"
New-AzFirewallNatRuleCollection -Name "MyNatRuleCollection" -Priority 1000 -Rule $rule1

In diesem Beispiel wird eine Auflistung mit einer Regel erstellt. Der gesamte Datenverkehr, der den in $rule 1 identifizierten Bedingungen entspricht, wird DNAT an übersetzte Adresse und portiert.

Beispiel 2: Hinzufügen einer Regel zu einer Regelauflistung

$rule1 = New-AzFirewallNatRule -Name R1 -Protocol "UDP","TCP" -SourceAddress "*" -DestinationAddress "10.0.0.1" -DestinationPort "80" -TranslatedAddress "10.0.0.2" -TranslatedPort "8080"
$ruleCollection = New-AzFirewallNatRuleCollection -Name "MyNatRuleCollection" -Priority 100 -Rule $rule1

$rule2 = New-AzFirewallNatRule -Name R2 -Protocol "TCP" -SourceAddress "*" -DestinationAddress "10.0.0.1" -DestinationPort "443" -TranslatedAddress "10.0.0.2" -TranslatedPort "8443"
$ruleCollection.AddRule($rule2)

In diesem Beispiel wird eine neue NAT-Regelauflistung mit einer Regel erstellt und dann der Regelauflistung eine zweite Regel mithilfe der Methode AddRule für das Regelauflistungsobjekt hinzugefügt. Jeder Regelname in einer bestimmten Regelauflistung muss einen eindeutigen Namen aufweisen und die Groß-/Kleinschreibung wird nicht beachtet.

Beispiel 3: Abrufen einer Regel aus einer Regelsammlung

$rule1 = New-AzFirewallNatRule -Name R1 -Protocol "TCP" -SourceAddress "10.0.0.0/24" -DestinationAddress "10.0.1.0/24" -DestinationPort "443" -TranslatedAddress "10.0.0.2" -TranslatedPort "8443"
$ruleCollection = New-AzFirewallNatRuleCollection -Name "MyNatRuleCollection" -Priority 100 -Rule $rule1

$rule=$ruleCollection.GetRuleByName("r1")

In diesem Beispiel wird eine neue NAT-Regelauflistung mit einer Regel erstellt und anschließend die Regel anhand des Namens abgerufen, wobei die Methode GetRuleByName für das Regelauflistungsobjekt aufgerufen wird. Der Regelname für die Methode "GetRuleByName" wird zwischen Groß- und Kleinschreibung unterschieden.

Beispiel 4: Entfernen einer Regel aus einer Regelsammlung

$rule1 = New-AzFirewallNatRule -Name R1 -Protocol "UDP","TCP" -SourceAddress "*" -DestinationAddress "10.0.0.1" -DestinationPort "80" -TranslatedAddress "10.0.0.2" -TranslatedPort "8080"
$rule2 = New-AzFirewallNatRule -Name R2 -Protocol "TCP" -SourceAddress "*" -DestinationAddress "10.0.0.1" -DestinationPort "443" -TranslatedAddress "10.0.0.2" -TranslatedPort "8443"
$ruleCollection = New-AzFirewallNatRuleCollection -Name "MyNatRuleCollection" -Priority 100 -Rule $rule1, $rule2
$ruleCollection.RemoveRuleByName("r1")

In diesem Beispiel wird eine neue NAT-Regelauflistung mit zwei Regeln erstellt und dann die erste Regel aus der Regelauflistung entfernt, indem die Methode RemoveRuleByName für das Regelauflistungsobjekt aufgerufen wird. Der Regelname für die Methode RemoveRuleByName wird zwischen Groß- und Kleinschreibung unterschieden.

Parameter

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Name

Gibt den Namen dieser NAT-Regel an. Der Name muss innerhalb einer Regelsammlung eindeutig sein.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Priority

Gibt die Priorität dieser Regel an. Priorität ist eine Zahl zwischen 100 und 65000. Je kleiner die Zahl, desto größer die Priorität.

Parametereigenschaften

Typ:UInt32
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Rule

Gibt die Liste der Regeln an, die unter dieser Auflistung gruppiert werden sollen.

Parametereigenschaften

Typ:

PSAzureFirewallNatRule[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

PSAzureFirewallNatRuleCollection