Partilhar via


New-AzureRmFirewallApplicationRuleCollection

Cria uma coleção de regras de aplicativos de firewall.

Aviso

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

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

Sintaxe

New-AzureRmFirewallApplicationRuleCollection
   -Name <String>
   -Priority <UInt32>
   -Rule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSAzureFirewallApplicationRule]>
   -ActionType <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzureRmFirewallApplicationRuleCollection cria uma coleção de Regras de Aplicativo de Firewall.

Exemplos

1: Criar uma coleção com uma regra

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

Este exemplo cria uma coleção com uma regra. Será permitido todo o tráfego que corresponda às condições identificadas no $rule 1. A primeira regra é para todo o tráfego HTTPS na porta 443 a partir de 10.0.0.0. Se houver outra coleção de regras de aplicativo com prioridade mais alta (número menor) que também corresponda ao tráfego identificado em $rule 1, a ação da coleção de regras com prioridade mais alta entrará em vigor.

2: Adicionar uma regra a uma coleção de regras

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

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

Este exemplo cria uma nova coleção de regras de aplicativo com uma regra e, em seguida, adiciona uma segunda regra à coleção de regras usando o método AddRule no objeto de coleção de regras. Cada nome de regra em uma determinada coleção de regras deve ter um nome exclusivo e não diferencia maiúsculas de minúsculas.

3: Obter uma regra de uma coleção de regras

$rule1 = New-AzureRmFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzureRmFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$getRule=$ruleCollection.GetRuleByName("r1")

Este exemplo cria uma nova coleção de regras de aplicativo com uma regra e, em seguida, obtém a regra por nome, chamando o método GetRuleByName no objeto de coleção de regras. O nome da regra para o método GetRuleByName não diferencia maiúsculas de minúsculas.

4: Remover uma regra de uma coleção de regras

$rule1 = New-AzureRmFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$rule2 = New-AzureRmFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" 
$ruleCollection = New-AzureRmFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1, $rule1 -ActionType "Allow"
$ruleCollection.RemoveRuleByName("r1")

Este exemplo cria uma nova coleção de regras de aplicativo com duas regras e, em seguida, remove a primeira regra da coleção de regras chamando o método RemoveRuleByName no objeto de coleção de regras. O nome da regra para o método RemoveRuleByName não diferencia maiúsculas de minúsculas.

Parâmetros

-ActionType

A ação da coleção de regras

Tipo:String
Valores aceites:Allow, Deny
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome desta regra de aplicativo. O nome deve ser exclusivo dentro de uma coleção de regras.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Priority

Especifica a prioridade desta regra. A prioridade é um número entre 100 e 65000. Quanto menor o número, maior a prioridade.

Tipo:UInt32
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Rule

Especifica a lista de regras a serem agrupadas nesta coleção.

Tipo:List<T>[PSAzureFirewallApplicationRule]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Este cmdlet não aceita nenhuma entrada.

Saídas

Microsoft.Azure.Commands.Network.Models.PSFirewallApplicationRuleCollection