New-AzFirewallApplicationRuleCollection

Sintaxis

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

-Confirm

-DefaultProfile

-Name

-Priority

-Rule

-WhatIf

Entradas

None

Salidas

PSAzureFirewallApplicationRuleCollection

Vínculos relacionados

• New-AzFirewallApplicationRule
• New-AzFirewall
• Get-AzFirewall