Share via


Get-AzureRmFirewall

Obtiene una instancia de Azure Firewall.

Advertencia

El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Syntax

Get-AzureRmFirewall
   [-Name <String>]
   [-ResourceGroupName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Get-AzureRmFirewall obtiene uno o varios firewalls de un grupo de recursos.

Ejemplos

1: Recuperación de todos los firewalls de un grupo de recursos

Get-AzureRmFirewall -ResourceGroupName rgName

En este ejemplo se recuperan todos los firewalls del grupo de recursos "rgName".

2: Recuperar un firewall por nombre

Get-AzureRmFirewall -ResourceGroupName rgName -Name azFw

En este ejemplo se recupera firewall denominado "azFw" en el grupo de recursos "rgName".

3: Recuperar un firewall y, a continuación, agregar una colección de reglas de aplicación al Firewall

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$appRule = New-AzureRmFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$appRuleCollection = New-AzureRmFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $appRule -ActionType "Allow"
$azFw.AddApplicationRuleCollection($appRuleCollection)

En este ejemplo se recupera un firewall y, a continuación, se agrega una colección de reglas de aplicación al firewall mediante una llamada al método AddApplicationRuleCollection.

4: Recuperar un firewall y, a continuación, agregar una colección de reglas de red al firewall

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$netRule = New-AzureRmFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol "Udp" -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$netRuleCollection = New-AzureRmFirewallNetworkRuleCollection -Name "MyNetworkRuleCollection" -Priority 100 -Rule $netRule -ActionType "Allow"
$azFw.AddNetworkRuleCollection($netRuleCollection)

En este ejemplo se recupera un firewall y, a continuación, se agrega una colección de reglas de red al firewall mediante una llamada al método AddNetworkRuleCollection.

5: Recuperar un firewall y, a continuación, recuperar una colección de reglas de aplicación por nombre del firewall

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$getAppRc=$azFw.GetApplicationRuleCollectionByName("MyAppRuleCollection")

En este ejemplo se recupera un firewall y, a continuación, se obtiene una colección de reglas por nombre, llamando al método GetApplicationRuleCollectionByName en el objeto de firewall. El nombre de la colección de reglas para el método GetApplicationRuleCollectionByName no distingue mayúsculas de minúsculas.

6: Recuperar un firewall y, a continuación, recuperar una colección de reglas de red por nombre del firewall

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$getNetRc=$azFw.GetNetworkRuleCollectionByName("MyNetworkRuleCollection")

En este ejemplo se recupera un firewall y, a continuación, se obtiene una colección de reglas por nombre, llamando al método GetNetworkRuleCollectionByName en el objeto de firewall. El nombre de la colección de reglas para el método GetNetworkRuleCollectionByName no distingue mayúsculas de minúsculas.

7: Recuperar un firewall y, a continuación, quitar una colección de reglas de aplicación por nombre del Firewall

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$azFw.RemoveApplicationRuleCollectionByName("MyAppRuleCollection")

En este ejemplo se recupera un firewall y, a continuación, se quita una colección de reglas por nombre, llamando al método RemoveApplicationRuleCollectionByName en el objeto de firewall. El nombre de la colección de reglas para el método RemoveApplicationRuleCollectionByName no distingue mayúsculas de minúsculas.

8: Recuperar un firewall y, a continuación, quitar una colección de reglas de red por nombre del firewall

$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$azFw.RemoveNetworkRuleCollectionByName("MyNetworkRuleCollection")

En este ejemplo se recupera un firewall y, a continuación, se quita una colección de reglas por nombre, llamando al método RemoveNetworkRuleCollectionByName en el objeto de firewall. El nombre de la colección de reglas para el método RemoveNetworkRuleCollectionByName no distingue mayúsculas de minúsculas.

9: Recuperar un firewall y, a continuación, asignar el firewall

$vnet=Get-AzureRmVirtualNetwork -Name "vnet" -ResourceGroupName "rgName"
$publicIp=Get-AzureRmPublicIpAddress -Name "firewallpip" -ResourceGroupName "rgName"
$azFw=Get-AzureRmFirewall -Name "azFw" -ResourceGroupName "rgName"
$azFw.Allocate($vnet, $publicIp)

En este ejemplo se recupera un firewall y se llama a Allocate en el firewall para iniciar el servicio de firewall mediante la configuración (colecciones de reglas de aplicación y red) asociadas al firewall.

Parámetros

-DefaultProfile

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

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

-Name

Especifica el nombre del firewall que obtiene este cmdlet.

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

-ResourceGroupName

Especifica el nombre del grupo de recursos al que pertenece firewall.

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

Entradas

None

Este cmdlet no acepta entradas.

Salidas

PSAzureFirewall