Set-CMWindowsFirewallPolicy  
更改 Windows 防火墙策略的设置。
语法
Set-CMWindowsFirewallPolicy
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-DomainBlockAllInboundTraffic <SettingType>]
   [-DomainNotification <SettingType>]
   [-DomainTurnOnFirewall <SettingType>]
   [-InputObject] <IResultObject>
   [-NewName <String>]
   [-PrivateBlockAllInboundTraffic <SettingType>]
   [-PrivateNotification <SettingType>]
   [-PrivateTurnOnFirewall <SettingType>]
   [-PublicBlockAllInboundTraffic <SettingType>]
   [-PublicNotification <SettingType>]
   [-PublicTurnOnFirewall <SettingType>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  Set-CMWindowsFirewallPolicy
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-DomainBlockAllInboundTraffic <SettingType>]
   [-DomainNotification <SettingType>]
   [-DomainTurnOnFirewall <SettingType>]
   [-Id] <Int32>
   [-NewName <String>]
   [-PrivateBlockAllInboundTraffic <SettingType>]
   [-PrivateNotification <SettingType>]
   [-PrivateTurnOnFirewall <SettingType>]
   [-PublicBlockAllInboundTraffic <SettingType>]
   [-PublicNotification <SettingType>]
   [-PublicTurnOnFirewall <SettingType>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  Set-CMWindowsFirewallPolicy
   [-Description <String>]
   [-Digest <ConfigurationItem>]
   [-DigestPath <String>]
   [-DigestXml <String>]
   [-DomainBlockAllInboundTraffic <SettingType>]
   [-DomainNotification <SettingType>]
   [-DomainTurnOnFirewall <SettingType>]
   [-Name] <String>
   [-NewName <String>]
   [-PrivateBlockAllInboundTraffic <SettingType>]
   [-PrivateNotification <SettingType>]
   [-PrivateTurnOnFirewall <SettingType>]
   [-PublicBlockAllInboundTraffic <SettingType>]
   [-PublicNotification <SettingType>]
   [-PublicTurnOnFirewall <SettingType>]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  Set-CMWindowsFirewallPolicy
   [-Id] <Int32>
   -Order <PriorityChangeType>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  Set-CMWindowsFirewallPolicy
   [-InputObject] <IResultObject>
   -Order <PriorityChangeType>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  Set-CMWindowsFirewallPolicy
   [-Name] <String>
   -Order <PriorityChangeType>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]  说明
Set-CMWindowsFirewallPolicy cmdlet 更改 Configuration Manager 中 System Center 2016 Endpoint Protection 的一个或多个 Windows 防火墙策略的设置。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>。 有关详细信息,请参阅 入门。
示例
示例 1:使用名称降低 Windows 防火墙策略的优先级
PS XYZ:\> Set-CMWindowsFirewallPolicy -Priority Decrease -Name "WFPContoso01"此命令会降低名为 WFPContoso01 的 Windows 防火墙策略的优先级。
示例 2:使用 ID 降低 Windows 防火墙策略的优先级
PS XYZ:\> Set-CMWindowsFirewallPolicy -Priority Decrease -Id "16777568"此命令会降低 ID 为16777568的 Windows 防火墙策略的优先级。
示例 3:使用对象变量提高 Windows 防火墙策略的优先级
PS XYZ:\> $WFPobj=Get-CMWindowsFirewallPolicy -Id "16777568"
PS XYZ:\> Set-CMWindowsFirewallPolicy -Priority Increase -InputObject $WFPobj第一个命令获取具有 ID 16777568的 CMWindowsFirewallPolicy 对象,并将其存储在 $WFPobj 变量中。
第二个命令增加了存储在 $WFPobj 变量中的 Windows 防火墙策略的优先级。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| 类型: | SwitchParameter | 
| 别名: | cf | 
| Position: | Named | 
| 默认值: | False | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Description
指定 Windows 防火墙策略的说明。
| 类型: | String | 
| 别名: | LocalizedDescription | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Digest
| 类型: | ConfigurationItem | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | True | 
| 接受通配符: | False | 
-DigestPath
| 类型: | String | 
| 别名: | DesiredConfigurationDigestPath | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DigestXml
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DomainBlockAllInboundTraffic
指定防火墙是否阻止域类型网络位置的所有传入流量。 有效值包含:
- 否
- 未配置
- 是
| 类型: | SettingType | 
| 接受的值: | Yes, No, NotConfigured | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DomainNotification
| 类型: | SettingType | 
| 别名: | DomainNotifications | 
| 接受的值: | Yes, No, NotConfigured | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-DomainTurnOnFirewall
指定是否为域网络位置启用 Windows 防火墙。 有效值包含:
- 否
- 未配置
- 是
| 类型: | SettingType | 
| 接受的值: | Yes, No, NotConfigured | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Id
指定防火墙策略的 ID 数组。
| 类型: | Int32 | 
| 别名: | CIId, CI_ID | 
| Position: | 0 | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-InputObject
指定 CMWindowsFirewallPolicy 对象。 若要获取 CMWindowsFirewallPolicy 对象,请使用 Get-CMWindowsFirewallPolicy cmdlet。
| 类型: | IResultObject | 
| Position: | 0 | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | True | 
| 接受通配符: | False | 
-Name
指定防火墙策略名称的数组。
| 类型: | String | 
| 别名: | LocalizedDisplayName | 
| Position: | 0 | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-NewName
指定防火墙策略的新名称。
| 类型: | String | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-Order
{{ 填写订单说明 }}
| 类型: | PriorityChangeType | 
| 别名: | Priority | 
| 接受的值: | Increase, Decrease | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | True | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PassThru
添加此参数可返回一个对象,该对象表示正在使用的项。 默认情况下,此 cmdlet 可能不会生成任何输出。
| 类型: | SwitchParameter | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PrivateBlockAllInboundTraffic
指定防火墙是否阻止专用网络位置的所有传入流量。 有效值包含:
- 否
- 未配置
- 是
| 类型: | SettingType | 
| 接受的值: | Yes, No, NotConfigured | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PrivateNotification
| 类型: | SettingType | 
| 别名: | PrivateNotifications | 
| 接受的值: | Yes, No, NotConfigured | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PrivateTurnOnFirewall
指定是否为专用网络位置启用 Windows 防火墙。 有效值包含:
- 否
- 未配置
- 是
| 类型: | SettingType | 
| 接受的值: | Yes, No, NotConfigured | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PublicBlockAllInboundTraffic
指定防火墙是否阻止公用网络位置的所有传入流量。 有效值包含:
- 否
- 未配置
- 是
| 类型: | SettingType | 
| 接受的值: | Yes, No, NotConfigured | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PublicNotification
| 类型: | SettingType | 
| 别名: | PublicNotifications | 
| 接受的值: | Yes, No, NotConfigured | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-PublicTurnOnFirewall
指定是否为公用网络位置启用 Windows 防火墙。 有效值包含:
- 否
- 未配置
- 是
| 类型: | SettingType | 
| 接受的值: | Yes, No, NotConfigured | 
| Position: | Named | 
| 默认值: | None | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
| 类型: | SwitchParameter | 
| 别名: | wi | 
| Position: | Named | 
| 默认值: | False | 
| 必需: | False | 
| 接受管道输入: | False | 
| 接受通配符: | False | 
输入
Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItem
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object