New-AzFirewallNetworkRuleCollection

  • Referência
Módulo:
Az.Network

Cria uma Coleção de Regras de Rede da Rede de Firewall do Azure.

Sintaxe

New-AzFirewallNetworkRuleCollection
   -Name <String>
   -Priority <UInt32>
   -Rule <PSAzureFirewallNetworkRule[]>
   -ActionType <String>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet New-AzFirewallNetworkRuleCollection cria uma coleção de Regras de Rede de Firewall.

Exemplos

Exemplo 1: Criar uma coleção de rede com duas regras

$rule1 = New-AzFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol UDP -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$rule2 = New-AzFirewallNetworkRule -Name "partial-tcp-rule" -Description "Rule for all TCP traffic from 10.0.0.0 to 60.1.5.0:4040" -Protocol TCP -SourceAddress "10.0.0.0" -DestinationAddress "60.1.5.0" -DestinationPort "4040"
New-AzFirewallNetworkRuleCollection -Name RC1 -Priority 100 -Rule $rule1, $rule2 -ActionType "Allow"

Este exemplo cria uma coleção que permitirá todo o tráfego que corresponda a qualquer uma das duas regras. A primeira regra é para todo o tráfego UDP. A segunda regra é para o tráfego TCP de 10.0.0.0 a 60.1.5.0:4040. Se houver outra coleção de regras de rede com prioridade mais alta (número menor) que também corresponda ao tráfego identificado em $rule 1 ou $rule 2, a ação da coleção de regras com prioridade mais alta entrará em vigor.

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

$rule1 = New-AzFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol UDP -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$ruleCollection = New-AzFirewallNetworkRuleCollection -Name "MyNetworkRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"

$rule2 = New-AzFirewallNetworkRule -Name "partial-tcp-rule" -Description "Rule for all TCP traffic from 10.0.0.0 to 60.1.5.0:4040" -Protocol TCP -SourceAddress "10.0.0.0" -DestinationAddress "60.1.5.0" -DestinationPort "4040"
$ruleCollection.AddRule($rule2)

Este exemplo cria uma nova coleção de regras de rede 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.

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

$rule1 = New-AzFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol UDP -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$ruleCollection = New-AzFirewallNetworkRuleCollection -Name "MyNetworkRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$getRule=$ruleCollection.GetRuleByName("ALL-UDP-traffic")

Este exemplo cria uma nova coleção de regras de rede 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.

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

$rule1 = New-AzFirewallNetworkRule -Name "all-udp-traffic" -Description "Rule for all UDP traffic" -Protocol UDP -SourceAddress "*" -DestinationAddress "*" -DestinationPort "*"
$rule2 = New-AzFirewallNetworkRule -Name "partial-tcp-rule" -Description "Rule for all TCP traffic from 10.0.0.0 to 60.1.5.0:4040" -Protocol TCP -SourceAddress "10.0.0.0" -DestinationAddress "60.1.5.0" -DestinationPort "4040"
$ruleCollection = New-AzFirewallNetworkRuleCollection -Name "MyNetworkRuleCollection" -Priority 100 -Rule $rule1, $rule2 -ActionType "Allow"
$ruleCollection.RemoveRuleByName("ALL-udp-traffic")

Este exemplo cria uma nova coleção de regras de rede 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

Especifica a ação a ser tomada para as condições de correspondência de tráfego desta regra. As ações aceites são "Permitir" ou "Negar".

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:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome dessa coleção de regras de rede. O nome deve ser exclusivo em toda a coleção de regras de rede.

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

-Priority

Especifica a prioridade dessa coleção de regras. 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:PSAzureFirewallNetworkRule[]
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

Saídas

PSAzureFirewallNetworkRuleCollection