Partilhar via

Add-AzureRmNetworkSecurityRuleConfig

  • Referência
Módulo:
AzureRM.Network

Adiciona uma configuração de regra de segurança de rede a um grupo de segurança de rede.

Aviso

O módulo AzureRM 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.

Syntax

Add-AzureRmNetworkSecurityRuleConfig
   -Name <String>
   -NetworkSecurityGroup <PSNetworkSecurityGroup>
   [-Description <String>]
   [-Protocol <String>]
   [-SourcePortRange <System.Collections.Generic.List`1[System.String]>]
   [-DestinationPortRange <System.Collections.Generic.List`1[System.String]>]
   [-SourceAddressPrefix <System.Collections.Generic.List`1[System.String]>]
   [-DestinationAddressPrefix <System.Collections.Generic.List`1[System.String]>]
   [-SourceApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DestinationApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-Access <String>]
   [-Priority <Int32>]
   [-Direction <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmNetworkSecurityRuleConfig
   -Name <String>
   -NetworkSecurityGroup <PSNetworkSecurityGroup>
   [-Description <String>]
   [-Protocol <String>]
   [-SourcePortRange <System.Collections.Generic.List`1[System.String]>]
   [-DestinationPortRange <System.Collections.Generic.List`1[System.String]>]
   [-SourceAddressPrefix <System.Collections.Generic.List`1[System.String]>]
   [-DestinationAddressPrefix <System.Collections.Generic.List`1[System.String]>]
   [-SourceApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DestinationApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-Access <String>]
   [-Priority <Int32>]
   [-Direction <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Add-AzureRmNetworkSecurityRuleConfig adiciona uma configuração de regra de segurança de rede a um grupo de segurança de rede do Azure.

Exemplos

1: Adicionando um grupo de segurança de rede

Get-AzureRmNetworkSecurityGroup -Name  nsg1 -ResourceGroupName rg1 | 
Add-AzureRmNetworkSecurityRuleConfig -Name rdp-rule -Description "Allow RDP" -Access 
    Allow -Protocol Tcp -Direction Inbound -Priority 100 -SourceAddressPrefix Internet 
    -SourcePortRange * -DestinationAddressPrefix * -DestinationPortRange 3389 | 
    Set-AzureRmNetworkSecurityGroup

O primeiro comando recupera um grupo de segurança de rede do Azure chamado "nsg1" do grupo de recursos "rg1". O segundo comando adiciona uma regra de segurança de rede chamada "rdp-rule" que permite o tráfego da Internet na porta 3389 para o objeto de grupo de segurança de rede recuperado. Persiste o grupo de segurança de rede do Azure modificado.

2: Adicionando uma nova regra de segurança com grupos de segurança de aplicativos

$srcAsg = New-AzureRmApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name srcAsg -Location "West US"
$destAsg = New-AzureRmApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name destAsg -Location "West US"

Get-AzureRmNetworkSecurityGroup -Name  nsg1 -ResourceGroupName rg1 |
Add-AzureRmNetworkSecurityRuleConfig -Name rdp-rule -Description "Allow RDP" -Access
    Allow -Protocol Tcp -Direction Inbound -Priority 100 -SourceApplicationSecurityGroup
    $srcAsg -SourcePortRange * -DestinationApplicationSecurityGroup $destAsg -DestinationPortRange 3389 |
Set-AzureRmNetworkSecurityGroup

Primeiro, criamos dois novos grupos de segurança de aplicativos. Em seguida, recuperamos um grupo de segurança de rede do Azure chamado "nsg1" do grupo de recursos "rg1". e adicione uma regra de segurança de rede chamada "RDP-rule" a ela. A regra permite o tráfego de todas as configurações de IP no grupo de segurança do aplicativo "srcAsg" para todas as configurações de IP em "destAsg" na porta 3389. Depois de adicionar a regra, persistimos o grupo de segurança de rede do Azure modificado.

Parâmetros

-Access

Especifica se o tráfego de rede é permitido ou negado. Os valores aceitáveis para este parâmetro são: Permitir e Negar.

Tipo:String
valores aceites:Allow, Deny
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters: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
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

Especifica uma descrição de uma configuração de regra de segurança de rede.

Tipo:String
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationAddressPrefix

Especifica um prefixo de endereço de destino. Os valores aceitáveis para este parâmetro são:

  • Um endereço CIDR (Classless Interdomain Routing)
  • Um intervalo de endereços IP de destino
  • Um caractere curinga (*) para corresponder a qualquer endereço IP Você pode usar tags como VirtualNetwork, AzureLoadBalancer e Internet.
Tipo:List<T>[String]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationApplicationSecurityGroup

O grupo de segurança do aplicativo definido como destino para a regra. Ele não pode ser usado com o parâmetro 'DestinationAddressPrefix'.

Tipo:List<T>[PSApplicationSecurityGroup]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationApplicationSecurityGroupId

O grupo de segurança do aplicativo definido como destino para a regra. Ele não pode ser usado com o parâmetro 'DestinationAddressPrefix'.

Tipo:List<T>[String]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-DestinationPortRange

Especifica uma porta ou intervalo de destino. Os valores aceitáveis para este parâmetro são:

  • Um inteiro
  • Um intervalo de números inteiros entre 0 e 65535
  • Um caractere curinga (*) para corresponder a qualquer porta
Tipo:List<T>[String]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-Direction

Especifica se uma regra é avaliada no tráfego de entrada ou de saída. Os valores aceitáveis para este parâmetro são: Entrada e Saída.

Tipo:String
valores aceites:Inbound, Outbound
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de uma configuração de regra de segurança de rede.

Tipo:String
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-NetworkSecurityGroup

Especifica um objeto NetworkSecurityGroup . Este cmdlet adiciona uma configuração de regra de segurança de rede ao objeto especificado por esse parâmetro.

Tipo:PSNetworkSecurityGroup
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:True
Accept wildcard characters:False

-Priority

Especifica a prioridade de uma configuração de regra. Os valores aceitáveis para este parâmetro são: Um número inteiro entre 100 e 4096. O número de prioridade deve ser exclusivo para cada regra da coleção. Quanto menor o número de prioridade, maior a prioridade da regra.

Tipo:Int32
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-Protocol

Especifica o protocolo de rede ao qual uma configuração de regra se aplica. Os valores aceitáveis para este parâmetro são:

  • TCP
  • Udp
  • Caractere curinga (*) para corresponder a ambos
Tipo:String
valores aceites:Tcp, Udp, *
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceAddressPrefix

Especifica um prefixo de endereço de origem. Os valores aceitáveis para este parâmetro são:

  • Um CIDR
  • Um intervalo de IP de origem
  • Um caractere curinga (*) para corresponder a qualquer endereço IP. Você também pode usar tags como VirtualNetwork, AzureLoadBalancer e Internet.
Tipo:List<T>[String]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceApplicationSecurityGroup

O grupo de segurança do aplicativo definido como origem para a regra. Ele não pode ser usado com o parâmetro 'SourceAddressPrefix'.

Tipo:List<T>[PSApplicationSecurityGroup]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-SourceApplicationSecurityGroupId

O grupo de segurança do aplicativo definido como origem para a regra. Ele não pode ser usado com o parâmetro 'SourceAddressPrefix'.

Tipo:List<T>[String]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-SourcePortRange

Especifica uma porta ou intervalo de origem. Esse valor é expresso como um inteiro, como um intervalo entre 0 e 65535 ou como um caractere curinga (*) para corresponder a qualquer porta de origem.

Tipo:List<T>[String]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSNetworkSecurityGroup

Parâmetros: NetworkSecurityGroup (ByValue)

Saídas

PSNetworkSecurityGroup