你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
New-AzFirewallApplicationRuleCollection
创建防火墙应用程序规则的集合。
语法
New-AzFirewallApplicationRuleCollection
-Name <String>
-Priority <UInt32>
-Rule <PSAzureFirewallApplicationRule[]>
-ActionType <String>
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
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 中标识的条件匹配的所有流量。 第一个规则适用于端口 443 上 10.0.0.0 的所有 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 |
接受的值: | Allow, Deny |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Name
指定此应用程序规则的名称。 名称在规则集合中必须是唯一的。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Priority
指定此规则的优先级。 优先级是介于 100 和 65000 之间的数字。 数字越小,优先级越大。
类型: | UInt32 |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Rule
指定要在此集合下分组的规则列表。
类型: | PSAzureFirewallApplicationRule[] |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
None
输出
PSAzureFirewallApplicationRuleCollection