New-AzFirewallApplicationRuleCollection
Vytvoří kolekci pravidel aplikace brány firewall.
Syntax
Default (Výchozí)
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
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é: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
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 |
-Name
Určuje název tohoto pravidla aplikace. Název musí být v kolekci pravidel jedinečný.
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 |
-Priority
Určuje prioritu tohoto pravidla. Priorita je číslo v rozsahu 100 až 65000. Čím menší je číslo, tím větší je priorita.
Vlastnosti parametru
| Typ: | UInt32 |
| 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 |
-Rule
Určuje seznam pravidel, která se mají seskupit v této kolekci.
Vlastnosti parametru
| Typ: | |
| 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 |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
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.
