Set-AzNetworkSecurityRuleConfig
Atualiza uma configuração de regra de segurança de rede para um grupo de segurança de rede.
Sintaxe
SetByResource (Predefinição)
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, em seguida, armazena-o na variável $nsg.
O segundo comando usa o operador de pipeline para passar o security group em $nsg para Get-AzNetworkSecurityRuleConfig, que obtém a configuração da 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á nenhuma maneira de 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 este parâmetro são: Permitir e Negar.
Propriedades dos parâmetros
Tipo: String
Default value: None Valores aceites: Allow, Deny Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Propriedades dos parâmetros
Tipo: IAzureContextContainer
Default value: None Suporta carateres universais: False NãoMostrar: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Description
Especifica uma descrição para uma configuração de regra.
O tamanho máximo é de 140 caracteres.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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 marcas como VirtualNetwork, AzureLoadBalancer e Internet.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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 dos parâmetros
Conjuntos de parâmetros
SetByResource
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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 dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
SetByResourceId
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Direction
Especifica se uma regra é avaliada para tráfego de entrada ou de saída.
Os valores aceitáveis para este parâmetro são: Entrada e Saída.
Propriedades dos parâmetros
Tipo: String
Default value: None Valores aceites: Inbound, Outbound Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Name
Especifica o nome da configuração da regra de segurança de rede definida por este cmdlet.
Propriedades dos parâmetros
Tipo: String
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-NetworkSecurityGroup
Especifica o objeto NetworkSecurityGroup que contém a configuração da regra de segurança de rede a ser definida.
Propriedades dos parâmetros
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: True Valor do pipeline: True Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-Priority
Especifica a prioridade de uma configuração de regra.
Os valores aceitáveis para este parâmetro são:Um 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.
Propriedades dos parâmetros
Tipo: Int32
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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 dos parâmetros
Tipo: String
Default value: None Valores aceites: Tcp, Udp, Icmp, Esp, Ah, * Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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'.
Propriedades dos parâmetros
Conjuntos de parâmetros
SetByResource
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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'.
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
SetByResourceId
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: False
-SourcePortRange
Especifica a porta ou o intervalo de origem.
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
Propriedades dos parâmetros
Tipo: String [ ]
Default value: None Suporta carateres universais: False NãoMostrar: False
Conjuntos de parâmetros
(All)
Position: Named Obrigatório: False Valor do pipeline: False Valor do pipeline por nome de propriedade: False Valor dos restantes argumentos: 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
