Dela via

Set-AzNetworkSecurityRuleConfig

Modul:
Az.Network Module

Uppdaterar en nätverkssäkerhetsregelkonfiguration för en nätverkssäkerhetsgrupp.

Syntax

SetByResource (Standard) 

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

Cmdleten Set-AzNetworkSecurityRuleConfig uppdaterar en nätverkssäkerhetsregelkonfiguration för en nätverkssäkerhetsgrupp.

Exempel

Exempel 1: Ändra åtkomstkonfigurationen i en nätverkssäkerhetsregel

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

Det första kommandot hämtar nätverkssäkerhetsgruppen med namnet NSG-FrontEnd och lagrar den sedan i variabeln $nsg. Det andra kommandot använder pipelineoperatorn för att skicka säkerhetsgruppen i $nsg till Get-AzNetworkSecurityRuleConfig, som hämtar konfigurationen av säkerhetsregeln med namnet rdp-rule. Det tredje kommandot ändrar åtkomstkonfigurationen för rdp-rule till Neka. Detta skriver dock över regeln och anger endast de parametrar som skickas till funktionen Set-AzNetworkSecurityRuleConfig. Obs! Det finns inget sätt att ändra ett enda attribut

Exempel 2

Uppdaterar en nätverkssäkerhetsregelkonfiguration för en nätverkssäkerhetsgrupp. (autogenerated)

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

Exempel 3

Uppdaterar en nätverkssäkerhetsregelkonfiguration för en nätverkssäkerhetsgrupp. (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 *

Exempel 4

Uppdaterar en nätverkssäkerhetsregelkonfiguration för en nätverkssäkerhetsgrupp (käll-IP-adress)

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

Parametrar

-Access

Anger om nätverkstrafik tillåts eller nekas. De acceptabla värdena för den här parametern är: Tillåt och Neka.

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:Allow, Deny
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Parameteregenskaper

Typ:IAzureContextContainer
Standardvärde:None
Stöder jokertecken:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Description

Anger en beskrivning för en regelkonfiguration. Den maximala storleken är 140 tecken.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DestinationAddressPrefix

Anger ett måladressprefix. De godtagbara värdena för den här parametern är:

  • En CIDR-adress (Classless Interdomain Routing)
  • Ett mål-IP-adressintervall
  • Ett jokertecken (*) som matchar alla IP-adresser. Du kan använda taggar som VirtualNetwork, AzureLoadBalancer och Internet.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DestinationApplicationSecurityGroup

Programsäkerhetsgruppen har angetts som mål för regeln. Den kan inte användas med parametern DestinationAddressPrefix.

Parameteregenskaper

Typ:

PSApplicationSecurityGroup[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DestinationApplicationSecurityGroupId

Programsäkerhetsgruppen har angetts som mål för regeln. Den kan inte användas med parametern DestinationAddressPrefix.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-DestinationPortRange

Anger en målport eller ett målintervall. De godtagbara värdena för den här parametern är:

  • Ett heltal
  • Ett intervall med heltal mellan 0 och 65535
  • Ett jokertecken (*) som matchar alla portar

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Direction

Anger om en regel utvärderas för inkommande eller utgående trafik. De acceptabla värdena för den här parametern är: Inkommande och Utgående.

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:Inbound, Outbound
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Name

Anger namnet på nätverkssäkerhetsregelkonfigurationen som den här cmdleten anger.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-NetworkSecurityGroup

Anger det NetworkSecurityGroup-objekt som innehåller konfigurationen av nätverkssäkerhetsregeln som ska anges.

Parameteregenskaper

Typ:PSNetworkSecurityGroup
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Priority

Anger prioriteten för en regelkonfiguration. De acceptabla värdena för den här parametern är:Ett heltal mellan 100 och 4096. Prioritetsnumret måste vara unikt för varje regel i samlingen. Desto lägre prioritetsnummer, desto högre prioritet för regeln.

Parameteregenskaper

Typ:Int32
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Protocol

Anger det nätverksprotokoll som en regelkonfiguration gäller för. De godtagbara värdena för den här parametern är:

  • Tcp
  • Udp
  • Icmp
  • Esp
  • Ah
  • Jokertecken (*) för att matcha alla

Parameteregenskaper

Typ:String
Standardvärde:None
Godkända värden:Tcp, Udp, Icmp, Esp, Ah, *
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SourceAddressPrefix

Anger ett källadressprefix. De godtagbara värdena för den här parametern är:

  • En CIDR
  • Ett käll-IP-intervall
  • Ett jokertecken (*) som matchar alla IP-adresser. Du kan också använda taggar som VirtualNetwork, AzureLoadBalancer och Internet.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SourceApplicationSecurityGroup

Programsäkerhetsgruppen har angetts som källa för regeln. Det kan inte användas med parametern SourceAddressPrefix.

Parameteregenskaper

Typ:

PSApplicationSecurityGroup[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResource
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SourceApplicationSecurityGroupId

Programsäkerhetsgruppen har angetts som källa för regeln. Det kan inte användas med parametern SourceAddressPrefix.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

SetByResourceId
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-SourcePortRange

Anger källporten eller -intervallet. De godtagbara värdena för den här parametern är:

  • Ett heltal
  • Ett intervall med heltal mellan 0 och 65535
  • Ett jokertecken (*) som matchar alla portar

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Indata

PSNetworkSecurityGroup

Utdata

PSNetworkSecurityGroup