Set-AzNetworkSecurityRuleConfig
Atualiza uma configuração de regra de segurança de rede para um grupo de segurança de rede.
Sintaxe
SetByResource (Default)
Set-AzNetworkSecurityRuleConfig
-Name <String>
-NetworkSecurityGroup <PSNetworkSecurityGroup>
[-Description <String>]
[-Protocol <String>]
[-SourcePortRange <String[]>]
[-DestinationPortRange <String[]>]
[-SourceAddressPrefix <String[]>]
[-DestinationAddressPrefix <String[]>]
[-SourceApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
[-DestinationApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
[-Access <String>]
[-Priority <Int32>]
[-Direction <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SetByResourceId
Set-AzNetworkSecurityRuleConfig
-Name <String>
-NetworkSecurityGroup <PSNetworkSecurityGroup>
[-Description <String>]
[-Protocol <String>]
[-SourcePortRange <String[]>]
[-DestinationPortRange <String[]>]
[-SourceAddressPrefix <String[]>]
[-DestinationAddressPrefix <String[]>]
[-SourceApplicationSecurityGroupId <String[]>]
[-DestinationApplicationSecurityGroupId <String[]>]
[-Access <String>]
[-Priority <Int32>]
[-Direction <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet Set-AzNetworkSecurityRuleConfig atualiza uma configuração de regra de segurança de rede para um grupo de segurança de rede.
Exemplos
Exemplo 1: alterar a configuração de acesso em uma regra de segurança de rede
$nsg = Get-AzNetworkSecurityGroup -Name "NSG-FrontEnd" -ResourceGroupName "TestRG"
$nsg | Get-AzNetworkSecurityRuleConfig -Name "rdp-rule"
Set-AzNetworkSecurityRuleConfig -Name "rdp-rule" -NetworkSecurityGroup $nsg -Access "Deny"
O primeiro comando obtém o grupo de segurança de rede chamado NSG-FrontEnd e o armazena na variável $nsg.
O segundo comando usa o operador de pipeline para passar o grupo de segurança em $nsg para Get-AzNetworkSecurityRuleConfig, que obtém a configuração de regra de segurança chamada rdp-rule.
O terceiro comando altera a configuração de acesso da regra rdp para Negar. No entanto, isso substitui a regra e define apenas os parâmetros que são passados para a função Set-AzNetworkSecurityRuleConfig. OBSERVAÇÃO: Não há como alterar um único atributo
Exemplo 2
Atualiza uma configuração de regra de segurança de rede para um grupo de segurança de rede. (autogenerated)
Set-AzNetworkSecurityRuleConfig -Access Allow -DestinationAddressPrefix * -DestinationPortRange 3389 -Direction Inbound -Name 'rdp-rule' -NetworkSecurityGroup <PSNetworkSecurityGroup> -Priority 1 -Protocol Tcp -SourceAddressPrefix 'Internet' -SourcePortRange *
Exemplo 3
Atualiza uma configuração de regra de segurança de rede para um grupo de segurança de rede. (autogenerated)
Set-AzNetworkSecurityRuleConfig -Access Allow -Description 'Allow RDP' -DestinationAddressPrefix * -DestinationPortRange 3389 -Direction Inbound -Name 'rdp-rule' -NetworkSecurityGroup <PSNetworkSecurityGroup> -Priority 1 -Protocol Tcp -SourceAddressPrefix 'Internet' -SourcePortRange *
Exemplo 4
Atualiza uma configuração de regra de segurança de rede para um grupo de segurança de rede (endereço IP de origem)
$nsg = Get-AzNetworkSecurityGroup -ResourceGroupName "MyResource" -Name "MyNsg"
($nsg.SecurityRules | Where-Object {$_.Name -eq "RuleName"}).SourceAddressPrefix = ([System.String[]] @("xxx.xxx.xxx.xxx"))
$nsg | Set-AzNetworkSecurityGroup | Get-AzNetworkSecurityRuleConfig -Name "RuleName"
Parâmetros
-Access
Especifica se o tráfego de rede é permitido ou negado.
Os valores aceitáveis para esse parâmetro são: Permitir e Negar.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Valores aceitos: Allow, Deny Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.
Propriedades do parâmetro
Tipo: IAzureContextContainer
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Description
Especifica uma descrição para uma configuração de regra.
O tamanho máximo é de 140 caracteres.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DestinationAddressPrefix
Especifica um prefixo de endereço de destino.
Os valores aceitáveis para este parâmetro são:
Um endereço CIDR (Roteamento de Interdomínio sem Classe)
Um intervalo de endereços IP de destino
Um caractere curinga (*) para corresponder a qualquer endereço IP.
Você pode usar marcas como VirtualNetwork, AzureLoadBalancer e Internet.
Propriedades do parâmetro
Tipo: String [ ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: 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'.
Propriedades do parâmetro
Conjuntos de parâmetros
SetByResource
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: 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'.
Propriedades do parâmetro
Tipo: String [ ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
SetByResourceId
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DestinationPortRange
Especifica uma porta ou intervalo de destino.
Os valores aceitáveis para este parâmetro são:
Um inteiro
Um intervalo de inteiros entre 0 e 65535
Um caractere curinga (*) para corresponder a qualquer porta
Propriedades do parâmetro
Tipo: String [ ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Direction
Especifica se uma regra é avaliada para tráfego de entrada ou saída.
Os valores aceitáveis para esse parâmetro são: Entrada e Saída.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Valores aceitos: Inbound, Outbound Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Name
Especifica o nome da configuração da regra de segurança de rede que esse cmdlet define.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-NetworkSecurityGroup
Especifica o objeto NetworkSecurityGroup que contém a configuração da regra de segurança de rede a ser definida.
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: True Valor do pipeline: True Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Priority
Especifica a prioridade de uma configuração de regra.
Os valores aceitáveis para esse parâmetro são: um inteiro entre 100 e 4096.
O número de prioridade deve ser exclusivo para cada regra na coleção.
Quanto menor o número de prioridade, maior a prioridade da regra.
Propriedades do parâmetro
Tipo: Int32
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: 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
Icmp
Esp
Ah
Caractere curinga (*) para corresponder a todos
Propriedades do parâmetro
Tipo: String
Valor padrão: None Valores aceitos: Tcp, Udp, Icmp, Esp, Ah, * Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-SourceAddressPrefix
Especifica um prefixo de endereço de origem.
Os valores aceitáveis para este parâmetro são:
UMA CIDR
Um intervalo de IP de origem
Um caractere curinga (*) para corresponder a qualquer endereço IP.
Você também pode usar marcas como VirtualNetwork, AzureLoadBalancer e Internet.
Propriedades do parâmetro
Tipo: String [ ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-SourceApplicationSecurityGroup
O grupo de segurança do aplicativo definido como fonte para a regra. Ele não pode ser usado com o parâmetro 'SourceAddressPrefix'.
Propriedades do parâmetro
Conjuntos de parâmetros
SetByResource
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-SourceApplicationSecurityGroupId
O grupo de segurança do aplicativo definido como fonte para a regra. Ele não pode ser usado com o parâmetro 'SourceAddressPrefix'.
Propriedades do parâmetro
Tipo: String [ ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
SetByResourceId
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-SourcePortRange
Especifica a porta de origem ou o intervalo.
Os valores aceitáveis para este parâmetro são:
Um inteiro
Um intervalo de inteiros entre 0 e 65535
Um caractere curinga (*) para corresponder a qualquer porta
Propriedades do parâmetro
Tipo: String [ ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
