Share via


Get-AzureRmFirewall

Obtém um Firewall do Azure.

Aviso

O módulo do PowerShell do AzureRM foi oficialmente preterido em 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Syntax

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

Description

O cmdlet Get-AzureRmFirewall obtém um ou mais Firewalls em um grupo de recursos.

Exemplos

1: Recuperar todos os firewalls em um grupo de recursos

Get-AzureRmFirewall -ResourceGroupName rgName

Este exemplo recupera todos os Firewalls no grupo de recursos "rgName".

2: Recuperar um firewall pelo nome

Get-AzureRmFirewall -ResourceGroupName rgName -Name azFw

Este exemplo recupera o Firewall chamado "azFw" no grupo de recursos "rgName".

3: Recuperar um firewall e adicionar uma coleção de regras de aplicativo ao 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)

Este exemplo recupera um firewall e adiciona uma coleção de regras de aplicativo ao firewall chamando o método AddApplicationRuleCollection.

4: Recuperar um firewall e adicionar uma coleção de regras de rede ao 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)

Este exemplo recupera um firewall e adiciona uma coleção de regras de rede ao firewall chamando o método AddNetworkRuleCollection.

5: Recuperar um firewall e, em seguida, recuperar uma coleção de regras de aplicativo por nome do firewall

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

Este exemplo recupera um firewall e, em seguida, obtém uma coleção de regras por nome, chamando o método GetApplicationRuleCollectionByName no objeto de firewall. O nome da coleção de regras do método GetApplicationRuleCollectionByName não diferencia maiúsculas de minúsculas.

6: Recuperar um firewall e, em seguida, recuperar uma coleção de regras de rede por nome do firewall

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

Este exemplo recupera um firewall e, em seguida, obtém uma coleção de regras por nome, chamando o método GetNetworkRuleCollectionByName no objeto de firewall. O nome da coleção de regras do método GetNetworkRuleCollectionByName não diferencia maiúsculas de minúsculas.

7: Recuperar um firewall e remover uma coleção de regras de aplicativo por nome do Firewall

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

Este exemplo recupera um firewall e remove uma coleção de regras por nome, chamando o método RemoveApplicationRuleCollectionByName no objeto de firewall. O nome da coleção de regras do método RemoveApplicationRuleCollectionByName não diferencia maiúsculas de minúsculas.

8: Recuperar um firewall e remover uma coleção de regras de rede por nome do Firewall

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

Este exemplo recupera um firewall e remove uma coleção de regras por nome, chamando o método RemoveNetworkRuleCollectionByName no objeto de firewall. O nome da coleção de regras do método RemoveNetworkRuleCollectionByName não diferencia maiúsculas de minúsculas.

9: Recuperar um firewall e, em seguida, alocar o 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)

Este exemplo recupera um firewall e chama Allocate no firewall para iniciar o serviço de firewall usando a configuração (coleções de regras de aplicativo e rede) associada ao firewall.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

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

-Name

Especifica o nome do Firewall que esse cmdlet obtém.

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

-ResourceGroupName

Especifica o nome do grupo de recursos ao qual o Firewall pertence.

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

Entradas

None

Esse cmdlet não aceita nenhuma entrada.

Saídas

PSAzureFirewall