共用方式為


New-AzFirewallApplicationRuleCollection

建立防火牆應用程式規則的集合。

語法

Default (預設值)

New-AzFirewallApplicationRuleCollection
    -Name <String>
    -Priority <UInt32>
    -Rule <PSAzureFirewallApplicationRule[]>
    -ActionType <String>
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

New-AzFirewallApplicationRuleCollection Cmdlet 會建立防火牆應用程式規則的集合。

範例

範例 1:使用一個規則建立集合

$rule1 = New-AzFirewallApplicationRule -Name "httpsRule" -Protocol "https:443" -TargetFqdn "*" -SourceAddress "10.0.0.0"
New-AzFirewallApplicationRuleCollection -Name "MyAppRuleCollection" -Priority 1000 -Rule $rule1 -ActionType "Allow"

此範例會建立具有一個規則的集合。 將允許符合$rule 1中確定條件的所有流量。 第一個規則適用於來自 10.0.0.0 的連接埠 443 上的所有 HTTPS 流量。 如果有另一個具有較高優先順序 (較小數目) 的應用程式規則集合也符合 $rule 1 中識別的流量,則具有較高優先順序的規則集合的動作將會改為生效。

範例 2:將規則新增至規則集合

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

此範例會使用一個規則建立新的應用程式規則集合,然後在規則集合物件上使用方法 AddRule 將第二個規則新增至規則集合。 指定規則集合中的每個規則名稱都必須具有唯一的名稱,且不區分大小寫。

範例 3:從規則集合取得規則

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

此範例會使用一個規則建立新的應用程式規則集合,然後依名稱取得規則,並在規則集合物件上呼叫方法 GetRuleByName。 方法的規則名稱 GetRuleByName 不區分大小寫。

範例 4:從規則集合中移除規則

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

此範例會建立具有兩個規則的新應用程式規則集合,然後在規則集合物件上呼叫 RemoveRuleByName 方法,從規則集合中移除第一個規則。 方法 RemoveRuleByName 的規則名稱不區分大小寫。

參數

-ActionType

規則集合的動作

參數屬性

類型:String
預設值:None
接受的值:Allow, Deny
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:參閱

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

參數屬性

類型:IAzureContextContainer
預設值:None
支援萬用字元:False
不要顯示:False
別名:AzContext, AzureRmContext, AzureCredential

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Name

指定此應用程式規則的名稱。 名稱在規則集合中必須是唯一的。

參數屬性

類型:String
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Priority

指定此規則的優先順序。 優先順序是介於 100 到 65000 之間的數字。 數字越小,優先級越大。

參數屬性

類型:UInt32
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Rule

指定要分組在此集合下的規則清單。

參數屬性

類型:

PSAzureFirewallApplicationRule[]

預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:True
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 指令未執行。

參數屬性

類型:SwitchParameter
預設值:False
支援萬用字元:False
不要顯示:False
別名:威斯康星州

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters

輸入

None

輸出

PSAzureFirewallApplicationRuleCollection