Set-AzNetworkSecurityRuleConfig

Aggiorna la configurazione di una regola di sicurezza di rete per un gruppo di sicurezza di rete.

Sintassi

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>]
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>]

Descrizione

Il cmdlet Set-AzNetworkSecurityRuleConfig aggiorna una configurazione delle regole di sicurezza di rete per un gruppo di sicurezza di rete.

Esempio

Esempio 1: Modificare la configurazione di accesso in una regola di sicurezza di rete

$nsg = Get-AzNetworkSecurityGroup -Name "NSG-FrontEnd" -ResourceGroupName "TestRG"
$nsg | Get-AzNetworkSecurityRuleConfig -Name "rdp-rule"
Set-AzNetworkSecurityRuleConfig -Name "rdp-rule" -NetworkSecurityGroup $nsg -Access "Deny"

Il primo comando ottiene il gruppo di sicurezza di rete denominato NSG-FrontEnd e quindi lo archivia nella variabile $nsg. Il secondo comando usa l'operatore pipeline per passare il gruppo di sicurezza in $nsg a Get-AzNetworkSecurityRuleConfig, che ottiene la configurazione della regola di sicurezza denominata rdp-rule. Il terzo comando modifica la configurazione di accesso di rdp-rule in Deny. Tuttavia, questa sovrascrive la regola e imposta solo i parametri passati alla funzione Set-AzNetworkSecurityRuleConfig. NOTA: non è possibile modificare un singolo attributo

Esempio 2

Aggiorna la configurazione di una regola di sicurezza di rete per un gruppo di sicurezza di rete. (generato automaticamente)

Set-AzNetworkSecurityRuleConfig -Access Allow -DestinationAddressPrefix * -DestinationPortRange 3389 -Direction Inbound -Name 'rdp-rule' -NetworkSecurityGroup <PSNetworkSecurityGroup> -Priority 1 -Protocol Tcp -SourceAddressPrefix 'Internet' -SourcePortRange *

Esempio 3

Aggiorna la configurazione di una regola di sicurezza di rete per un gruppo di sicurezza di rete. (generato automaticamente)

Set-AzNetworkSecurityRuleConfig -Access Allow -Description 'Allow RDP' -DestinationAddressPrefix * -DestinationPortRange 3389 -Direction Inbound -Name 'rdp-rule' -NetworkSecurityGroup <PSNetworkSecurityGroup> -Priority 1 -Protocol Tcp -SourceAddressPrefix 'Internet' -SourcePortRange *

Esempio 4

Aggiorna la configurazione di una regola di sicurezza di rete per un gruppo di sicurezza di rete (indirizzo IP di origine)

$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"

Parametri

-Access

Specifica se il traffico di rete è consentito o negato. I valori accettabili per questo parametro sono: Allow e Deny.

Tipo:String
Valori accettati:Allow, Deny
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Description

Specifica una descrizione per la configurazione di una regola. La dimensione massima è di 140 caratteri.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DestinationAddressPrefix

Specifica un prefisso dell'indirizzo di destinazione. I valori validi per questo parametro sono:

  • Indirizzo CIDR (Classless Interdomain Routing)
  • Intervallo di indirizzi IP di destinazione
  • Carattere jolly (*) per trovare la corrispondenza con qualsiasi indirizzo IP. È possibile usare tag come VirtualNetwork, AzureLoadBalancer e Internet.
Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DestinationApplicationSecurityGroup

Il gruppo di sicurezza dell'applicazione impostato come destinazione per la regola. Non può essere usato con il parametro 'DestinationAddressPrefix'.

Tipo:PSApplicationSecurityGroup[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DestinationApplicationSecurityGroupId

Il gruppo di sicurezza dell'applicazione impostato come destinazione per la regola. Non può essere usato con il parametro 'DestinationAddressPrefix'.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DestinationPortRange

Specifica una porta o un intervallo di destinazione. I valori validi per questo parametro sono:

  • Intero
  • Intervallo di numeri interi compresi tra 0 e 65535
  • Carattere jolly (*) per trovare la corrispondenza con qualsiasi porta
Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Direction

Specifica se una regola viene valutata per il traffico in ingresso o in uscita. I valori accettabili per questo parametro sono: Inbound e Outbound.

Tipo:String
Valori accettati:Inbound, Outbound
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica il nome della configurazione della regola di sicurezza di rete impostata da questo cmdlet.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NetworkSecurityGroup

Specifica l'oggetto NetworkSecurityGroup che contiene la configurazione della regola di sicurezza di rete da impostare.

Tipo:PSNetworkSecurityGroup
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Priority

Specifica la priorità di una configurazione della regola. I valori accettabili per questo parametro sono:Numero intero compreso tra 100 e 4096. Il numero di priorità deve essere univoco per ogni regola nella raccolta. Più basso è il numero di priorità, maggiore sarà la priorità della regola.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Protocol

Specifica il protocollo di rete a cui si applica una configurazione di regola. I valori validi per questo parametro sono:

  • TCP
  • Udp
  • Icmp
  • Spagnolo
  • Ah
  • Carattere jolly (*) per trovare tutte le corrispondenze
Tipo:String
Valori accettati:Tcp, Udp, Icmp, Esp, Ah, *
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SourceAddressPrefix

Specifica un prefisso dell'indirizzo di origine. I valori validi per questo parametro sono:

  • A CIDR
  • Un intervallo IP di origine
  • Carattere jolly (*) per trovare la corrispondenza con qualsiasi indirizzo IP. È anche possibile usare tag come VirtualNetwork, AzureLoadBalancer e Internet.
Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SourceApplicationSecurityGroup

Il gruppo di sicurezza dell'applicazione impostato come origine per la regola. Non può essere usato con il parametro 'SourceAddressPrefix'.

Tipo:PSApplicationSecurityGroup[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SourceApplicationSecurityGroupId

Il gruppo di sicurezza dell'applicazione impostato come origine per la regola. Non può essere usato con il parametro 'SourceAddressPrefix'.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-SourcePortRange

Specifica la porta o l'intervallo di origine. I valori validi per questo parametro sono:

  • Intero
  • Intervallo di numeri interi compresi tra 0 e 65535
  • Carattere jolly (*) per trovare la corrispondenza con qualsiasi porta
Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSNetworkSecurityGroup

Output

PSNetworkSecurityGroup