Export (0) Print
Expand All
Expand Minimize

Set-CMWindowsFirewallPolicy

Updated: September 1, 2013

Applies To: System Center 2012 Configuration Manager SP1

Set-CMWindowsFirewallPolicy

Changes settings of a Windows Firewall policy.

Syntax

Parameter Set: SearchByNameMandatory
Set-CMWindowsFirewallPolicy -Name <String[]> [-Description <String> ] [-DomainBlockAllInboundTraffic <SettingType> {No | NotConfigured | Yes} ] [-DomainNotifications <SettingType> {No | NotConfigured | Yes} ] [-DomainTurnOnFirewall <SettingType> {No | NotConfigured | Yes} ] [-NewName <String> ] [-PrivateBlockAllInboundTraffic <SettingType> {No | NotConfigured | Yes} ] [-PrivateNotifications <SettingType> {No | NotConfigured | Yes} ] [-PrivateTurnOnFirewall <SettingType> {No | NotConfigured | Yes} ] [-PublicBlockAllInboundTraffic <SettingType> {No | NotConfigured | Yes} ] [-PublicNotifications <SettingType> {No | NotConfigured | Yes} ] [-PublicTurnOnFirewall <SettingType> {No | NotConfigured | Yes} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByIdMandatory
Set-CMWindowsFirewallPolicy -Id <String[]> [-Description <String> ] [-DomainBlockAllInboundTraffic <SettingType> {No | NotConfigured | Yes} ] [-DomainNotifications <SettingType> {No | NotConfigured | Yes} ] [-DomainTurnOnFirewall <SettingType> {No | NotConfigured | Yes} ] [-NewName <String> ] [-PrivateBlockAllInboundTraffic <SettingType> {No | NotConfigured | Yes} ] [-PrivateNotifications <SettingType> {No | NotConfigured | Yes} ] [-PrivateTurnOnFirewall <SettingType> {No | NotConfigured | Yes} ] [-PublicBlockAllInboundTraffic <SettingType> {No | NotConfigured | Yes} ] [-PublicNotifications <SettingType> {No | NotConfigured | Yes} ] [-PublicTurnOnFirewall <SettingType> {No | NotConfigured | Yes} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Set-CMWindowsFirewallPolicy -InputObject <IResultObject> [-Description <String> ] [-DomainBlockAllInboundTraffic <SettingType> {No | NotConfigured | Yes} ] [-DomainNotifications <SettingType> {No | NotConfigured | Yes} ] [-DomainTurnOnFirewall <SettingType> {No | NotConfigured | Yes} ] [-NewName <String> ] [-PrivateBlockAllInboundTraffic <SettingType> {No | NotConfigured | Yes} ] [-PrivateNotifications <SettingType> {No | NotConfigured | Yes} ] [-PrivateTurnOnFirewall <SettingType> {No | NotConfigured | Yes} ] [-PublicBlockAllInboundTraffic <SettingType> {No | NotConfigured | Yes} ] [-PublicNotifications <SettingType> {No | NotConfigured | Yes} ] [-PublicTurnOnFirewall <SettingType> {No | NotConfigured | Yes} ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetById
Set-CMWindowsFirewallPolicy -Id <String[]> -Priority <PriorityChangeType> {Decrease | Increase} [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetByName
Set-CMWindowsFirewallPolicy -Name <String[]> -Priority <PriorityChangeType> {Decrease | Increase} [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetByValue
Set-CMWindowsFirewallPolicy -InputObject <IResultObject> -Priority <PriorityChangeType> {Decrease | Increase} [-Confirm] [-WhatIf] [ <CommonParameters>]




Detailed Description

The Set-CMWindowsFirewallPolicy cmdlet changes settings of one or more Windows Firewall policies for Microsoft System Center 2012 Endpoint Protection in Microsoft System Center 2012 Configuration Manager.

Parameters

-Description<String>

Specifies a description for the Windows Firewall policy.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DomainBlockAllInboundTraffic<SettingType>

Specifies whether the firewall blocks all incoming traffic for a domain type network location. The acceptable values for this parameter are:

-- No
-- Not Configured
-- Yes


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DomainNotifications<SettingType>

Specifies whether Configuration Manager sends notifications to domain type network locations. The acceptable values for this parameter are:
-- No
-- Not Configured
-- Yes


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-DomainTurnOnFirewall<SettingType>

Specifies whether to enable Windows Firewall for domain network location. The acceptable values for this parameter are:

-- No
-- Not Configured
-- Yes


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Id<String[]>

Specifies an array of IDs of firewall policies.


Aliases

CIId

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-InputObject<IResultObject>

Specifies a CMWindowsFirewallPolicy object. To obtain a CMWindowsFirewallPolicy object, use the Get-CMWindowsFirewallPolicy cmdlet.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Name<String[]>

Specifies an array of firewall policy names.


Aliases

LocalizedDisplayName

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-NewName<String>

Specifies a new name for the firewall policy.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Priority<PriorityChangeType>

Sets the priority of a firewall policy. Valid values are Increase and Decrease.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PrivateBlockAllInboundTraffic<SettingType>

Specifies whether the firewall blocks all incoming traffic for a private network location. The acceptable values for this parameter are:

-- No
-- Not Configured
-- Yes


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PrivateNotifications<SettingType>

Specifies whether Configuration Manager sends notifications to private network locations. The acceptable values for this parameter are:

-- No
-- Not Configured
-- Yes


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PrivateTurnOnFirewall<SettingType>

Specifies whether to enable Windows Firewall for a private network location. The acceptable values for this parameter are:

-- No
-- Not Configured
-- Yes


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PublicBlockAllInboundTraffic<SettingType>

Specifies whether the firewall blocks all incoming traffic for a public network location. The acceptable values for this parameter are:

-- No
-- Not Configured
-- Yes


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PublicNotifications<SettingType>

Specifies whether Configuration Manager sends notifications to public network locations. The acceptable values for this parameter are:

-- No
-- Not Configured
-- Yes


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-PublicTurnOnFirewall<SettingType>

Specifies whether to enable Windows Firewall for a public network location. The acceptable values for this parameter are:

-- No
-- Not Configured
-- Yes


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-Confirm

Prompts you for confirmation before executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-WhatIf

Describes what would happen if you executed the command without actually executing the command.


Required?

false

Position?

named

Default Value

false

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Decrease the priority of a Windows Firewall policy by using a name

This command decreases the priority of the Windows Firewall policy named WFPContoso01.


PS C:\> Set-CMWindowsFirewallPolicy -Priority Decrease -Name "WFPContoso01"

Example 2: Decrease the priority of a Windows Firewall policy by using an ID

This command decreases the priority of the Windows Firewall policy that has the ID 16777568.


PS C:\> Set-CMWindowsFirewallPolicy -Priority Decrease -ID "16777568"

Example 3: Increase the priority of a Windows Firewall policy by using an object variable

In this example, the first command gets the CMWindowsFirewallPolicy object that has the ID 16777568 and stores it in the $WFPobj variable.

The second command decreases the priority of the Windows Firewall policy stored in the $WFPobj variable.


PS C:\> $WFPobj=Get-CMWindowsFirewallPolicy -ID "16777568"PS C:\>Set-CMWindowsFirewallPolicy -Priority increase -InputObject $WFPobj

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft