New-AzFirewallApplicationRuleCollection

  • Referencia
Módulo:
Az.Network

Crea una colección de reglas de aplicación de firewall.

Syntax

New-AzFirewallApplicationRuleCollection
   -Name <String>
   -Priority <UInt32>
   -Rule <PSAzureFirewallApplicationRule[]>
   -ActionType <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet New-AzFirewallApplicationRuleCollection crea una colección de reglas de aplicación de firewall.

Ejemplos

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

$rule1 = New-AzFirewallApplicationRule -Name "httpsRule" -Protocol "https:443" -TargetFqdn "*" -SourceAddress "10.0.0.0"
New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 1000 -Rule $rule1 -ActionType "Allow"

En este ejemplo se crea una colección con una regla. Se permitirá todo el tráfico que coincida con las condiciones identificadas en $rule 1. La primera regla es para todo el tráfico HTTPS en el puerto 443 de 10.0.0.0. Si hay otra colección de reglas de aplicación con mayor prioridad (número menor), que también coincide con el tráfico identificado en $rule 1, la acción de la colección de reglas con mayor prioridad surtirá efecto en su lugar.

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

$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"

$rule2 = New-AzFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" 
$ruleCollection.AddRule($rule2)

En este ejemplo se crea una nueva colección de reglas de aplicación 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-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$getRule=$ruleCollection.GetRuleByName("r1")

En este ejemplo se crea una nueva colección de reglas de aplicación 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-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$rule2 = New-AzFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" 
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1, $rule1 -ActionType "Allow"
$ruleCollection.RemoveRuleByName("r1")

En este ejemplo se crea una nueva colección de reglas de aplicación 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

-ActionType

Acción de la colección de reglas

Type:String
Accepted values:Allow, Deny
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-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 de aplicación. 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:PSAzureFirewallApplicationRule[]
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

PSAzureFirewallApplicationRuleCollection