Get-AzureRmFirewall
Obtiene una instancia de Azure Firewall.
Advertencia
El módulo AzureRM PowerShell ha quedado oficialmente obsoleto 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 recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda 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.
Sintaxis
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.
Tipo: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Name
Especifica el nombre del firewall que obtiene este cmdlet.
Tipo: | String |
Alias: | ResourceName |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-ResourceGroupName
Especifica el nombre del grupo de recursos al que pertenece firewall.
Tipo: | String |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
Entradas
None
Este cmdlet no acepta entradas.