Sdílet prostřednictvím


Add-AzNetworkSecurityRuleConfig

Přidá konfiguraci pravidla zabezpečení sítě do skupiny zabezpečení sítě.

Syntax

SetByResource (Výchozí)

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

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

Rutina Add-AzNetworkSecurityRuleConfig přidá konfiguraci pravidla zabezpečení sítě do skupiny zabezpečení sítě Azure.

Příklady

Příklad 1: Přidání skupiny zabezpečení sítě

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

První příkaz načte skupinu zabezpečení sítě Azure s názvem nsg1 ze skupiny prostředků rg1. Druhý příkaz přidá pravidlo zabezpečení sítě s názvem "rdp-rule", které umožňuje provoz z internetu na portu 3389 do načteného objektu skupiny zabezpečení sítě. Zachová upravenou skupinu zabezpečení sítě Azure.

Příklad 2: Přidání nového pravidla zabezpečení se skupinami zabezpečení aplikace

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

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

Nejprve vytvoříme dvě nové skupiny zabezpečení aplikace. Potom načteme skupinu zabezpečení sítě Azure s názvem nsg1 ze skupiny prostředků rg1. a přidejte do něj pravidlo zabezpečení sítě s názvem rdp-rule. Pravidlo povoluje provoz ze všech konfigurací IP adres ve skupině zabezpečení aplikace "srcAsg" do všech konfigurací IP adres v destAsg na portu 3389. Po přidání pravidla zachováme upravenou skupinu zabezpečení sítě Azure.

Parametry

-Access

Určuje, jestli je povolený nebo zakázaný síťový provoz. Přijatelné hodnoty pro tento parametr jsou: Povolit a Odepřít.

Vlastnosti parametru

Typ:String
Default value:None
Přípustné hodnoty:Allow, Deny
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DefaultProfile

Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.

Vlastnosti parametru

Typ:IAzureContextContainer
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Description

Určuje popis konfigurace pravidla zabezpečení sítě.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DestinationAddressPrefix

Určuje předponu cílové adresy. Přijatelné hodnoty pro tento parametr jsou:

  • Adresa CIDR (Classless Interdomain Routing)
  • Rozsah cílových IP adres
  • Zástupný znak (*) odpovídající libovolné IP adrese. Můžete použít značky, jako jsou VirtualNetwork, AzureLoadBalancer a Internet.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DestinationApplicationSecurityGroup

Skupina zabezpečení aplikace nastavená jako cíl pravidla. Nedá se použít s parametrem DestinationAddressPrefix.

Vlastnosti parametru

Typ:

PSApplicationSecurityGroup[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResource
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DestinationApplicationSecurityGroupId

Skupina zabezpečení aplikace nastavená jako cíl pravidla. Nedá se použít s parametrem DestinationAddressPrefix.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResourceId
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-DestinationPortRange

Určuje cílový port nebo rozsah. Přijatelné hodnoty pro tento parametr jsou:

  • Celé číslo
  • Rozsah celých čísel mezi 0 a 65535
  • Zástupný znak (*) odpovídající libovolnému portu

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Direction

Určuje, jestli je pravidlo vyhodnoceno pro příchozí nebo odchozí provoz. Přijatelné hodnoty pro tento parametr jsou: Příchozí a Odchozí.

Vlastnosti parametru

Typ:String
Default value:None
Přípustné hodnoty:Inbound, Outbound
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Name

Určuje název konfigurace pravidla zabezpečení sítě.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-NetworkSecurityGroup

Určuje objekt NetworkSecurityGroup . Tato rutina přidá do objektu, který určuje tento parametr, konfiguraci pravidla zabezpečení sítě.

Vlastnosti parametru

Typ:PSNetworkSecurityGroup
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Priority

Určuje prioritu konfigurace pravidla. Přijatelné hodnoty pro tento parametr jsou: Celé číslo mezi 100 a 4096. Číslo priority musí být jedinečné pro každé pravidlo v kolekci. Čím nižší je číslo priority, tím vyšší je priorita pravidla.

Vlastnosti parametru

Typ:Int32
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Protocol

Určuje síťový protokol, na který se vztahuje konfigurace pravidla. Přijatelné hodnoty pro tento parametr jsou:

  • Protokol tcp
  • Protokol udp
  • Icmp
  • Esp
  • Ach
  • Zástupný znak (*) odpovídající všem

Vlastnosti parametru

Typ:String
Default value:None
Přípustné hodnoty:Tcp, Udp, Icmp, Esp, Ah, *
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SourceAddressPrefix

Určuje předponu zdrojové adresy. Přijatelné hodnoty pro tento parametr jsou:

  • A CIDR
  • Rozsah zdrojových IP adres
  • Zástupný znak (*) odpovídající libovolné IP adrese. Můžete také použít značky, jako jsou VirtualNetwork, AzureLoadBalancer a Internet.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SourceApplicationSecurityGroup

Skupina zabezpečení aplikace nastavená jako zdroj pravidla. Nedá se použít s parametrem SourceAddressPrefix.

Vlastnosti parametru

Typ:

PSApplicationSecurityGroup[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResource
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SourceApplicationSecurityGroupId

Skupina zabezpečení aplikace nastavená jako zdroj pravidla. Nedá se použít s parametrem SourceAddressPrefix.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

SetByResourceId
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-SourcePortRange

Určuje zdrojový port nebo rozsah. Tato hodnota se vyjadřuje jako celé číslo v rozsahu od 0 do 65535 nebo jako zástupný znak (*) odpovídající jakémukoli zdrojovému portu.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

PSNetworkSecurityGroup

Výstupy

PSNetworkSecurityGroup