New-AzFirewallApplicationRuleCollection
Vytvoří kolekci pravidel aplikace brány firewall.
Syntaxe
New-AzFirewallApplicationRuleCollection
-Name <String>
-Priority <UInt32>
-Rule <PSAzureFirewallApplicationRule[]>
-ActionType <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Rutina New-AzFirewallApplicationRuleCollection vytvoří kolekci pravidel aplikace brány firewall.
Příklady
Příklad 1: Vytvoření kolekce s jedním pravidlem
$rule1 = New-AzFirewallApplicationRule -Name "httpsRule" -Protocol "https:443" -TargetFqdn "*" -SourceAddress "10.0.0.0"
New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 1000 -Rule $rule1 -ActionType "Allow"
Tento příklad vytvoří kolekci s jedním pravidlem. Veškerý provoz, který odpovídá podmínkám identifikovaným v $rule 1, bude povolený. Prvním pravidlem je veškerý provoz HTTPS na portu 443 z verze 10.0.0.0. Pokud existuje jiná kolekce pravidel aplikace s vyšší prioritou (menší číslo), která také odpovídá provozu identifikovanému v $rule 1, akce kolekce pravidel s vyšší prioritou se místo toho projeví.
Příklad 2: Přidání pravidla do kolekce pravidel
$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$rule2 = New-AzFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com"
$ruleCollection.AddRule($rule2)
Tento příklad vytvoří novou kolekci pravidel aplikace s jedním pravidlem a pak přidá druhé pravidlo do kolekce pravidel pomocí metody AddRule u objektu kolekce pravidel. Každý název pravidla v dané kolekci pravidel musí mít jedinečný název a nerozlišuje velká a malá písmena.
Příklad 3: Získání pravidla z kolekce pravidel
$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1 -ActionType "Allow"
$getRule=$ruleCollection.GetRuleByName("r1")
Tento příklad vytvoří novou kolekci pravidel aplikace s jedním pravidlem a poté získá pravidlo podle názvu, volání metody GetRuleByName u objektu kolekce pravidel. Název pravidla pro metodu GetRuleByName nerozlišuje velká a malá písmena.
Příklad 4: Odebrání pravidla z kolekce pravidel
$rule1 = New-AzFirewallApplicationRule -Name R1 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com" -SourceAddress "10.0.0.0"
$rule2 = New-AzFirewallApplicationRule -Name R2 -Protocol "http:80","https:443" -TargetFqdn "*google.com", "*microsoft.com"
$ruleCollection = New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 100 -Rule $rule1, $rule1 -ActionType "Allow"
$ruleCollection.RemoveRuleByName("r1")
Tento příklad vytvoří novou kolekci pravidel aplikace se dvěma pravidly a pak odebere první pravidlo z kolekce pravidel voláním metody RemoveRuleByName u objektu kolekce pravidel. Název pravidla pro metodu RemoveRuleByName nerozlišuje malá a velká písmena.
Parametry
-ActionType
Akce kolekce pravidel
Typ: | String |
Přípustné hodnoty: | Allow, Deny |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním rutiny zobrazí výzvu k potvrzení.
Typ: | SwitchParameter |
Aliasy: | cf |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-DefaultProfile
Přihlašovací údaje, účet, tenant a předplatné používané ke komunikaci s Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Name
Určuje název tohoto pravidla aplikace. Název musí být v kolekci pravidel jedinečný.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Priority
Určuje prioritu tohoto pravidla. Priorita je číslo v rozsahu 100 až 65000. Čím menší je číslo, tím větší je priorita.
Typ: | UInt32 |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-Rule
Určuje seznam pravidel, která se mají seskupit v této kolekci.
Typ: | PSAzureFirewallApplicationRule[] |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-WhatIf
Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.
Typ: | SwitchParameter |
Aliasy: | wi |
Position: | Named |
Default value: | False |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
None
Výstupy
PSAzureFirewallApplicationRuleCollection
Související odkazy
Azure PowerShell