New-AzFirewallNatRuleCollection

  • Referencia
Módulo:
Az.Network

Crea una colección de reglas NAT de firewall.

Syntax

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

Description

El cmdlet New-AzFirewallNatRuleCollection crea una colección de reglas NAT de firewall.

Ejemplos

Ejemplo 1: Creación de una colección con una regla

$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

En este ejemplo se crea una colección con una regla. Todo el tráfico que coincida con las condiciones identificadas en $rule 1 será DNAT'ed para la dirección traducida y el puerto.

Ejemplo 2: Agregar una regla a una colección de reglas

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

En este ejemplo se crea una nueva colección de reglas NAT con una regla y, a continuación, se agrega una segunda regla a la colección de reglas mediante el método AddRule en el objeto de colección de reglas. Cada nombre de regla de una colección de reglas determinada debe tener un nombre único y no distingue mayúsculas de minúsculas.

Ejemplo 3: Obtener una regla de una colección de reglas

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

En este ejemplo se crea una nueva colección de reglas NAT con una regla y, a continuación, se obtiene la regla por nombre, llamando al método GetRuleByName en el objeto de colección de reglas. El nombre de regla del método GetRuleByName no distingue mayúsculas de minúsculas.

Ejemplo 4: Eliminación de una regla de una colección de reglas

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

En este ejemplo se crea una nueva colección de reglas NAT con dos reglas y, a continuación, se quita la primera regla de la colección de reglas llamando al método RemoveRuleByName en el objeto de colección de reglas. El nombre de regla del método RemoveRuleByName no distingue mayúsculas de minúsculas.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

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

-Name

Especifica el nombre de esta regla NAT. El nombre debe ser único dentro de una colección de reglas.

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

-Priority

Especifica la prioridad de esta regla. La prioridad es un número comprendido entre 100 y 65000. Cuanto menor sea el número, mayor será la prioridad.

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

-Rule

Especifica la lista de reglas que se van a agrupar en esta colección.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

None

Salidas

PSAzureFirewallNatRuleCollection