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