Remove-CMWindowsFirewallPolicy
Applies To: System Center 2012 Configuration Manager SP1
[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]
Remove-CMWindowsFirewallPolicy
Removes Windows Firewall policies for Endpoint Protection.
Syntax
Parameter Set: SearchByNameMandatory
Remove-CMWindowsFirewallPolicy -Name <String[]> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByIdMandatory
Remove-CMWindowsFirewallPolicy -Id <String[]> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByValueMandatory
Remove-CMWindowsFirewallPolicy -InputObject <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Remove-CMWindowsFirewallPolicy cmdlet removes one or more Windows Firewall policies Microsoft System Center 2012 Endpoint Protection in Microsoft System Center 2012 Configuration Manager. When you remove a Windows Firewall policy, System Center 2012 Configuration Manager removes the policy from the computers on which you deployed the policy.
Parameters
-Force
Removes the Windows Firewall policies without prompting you for confirmation. By default, the cmdlet prompts you for confirmation before it proceeds.
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 Windows 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 Windows Firewall policy names.
Aliases |
LocalizedDisplayName |
Required? |
true |
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.
Examples
Example 1: Remove a Windows Firewall policy by using a name
This command removes the Windows Firewall policy that has the ID WFPContoso01.
PS C:\> Remove-CMWindowsFirewallPolicy -Name "WFPContoso01"
Example 2: Remove 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 removes the Windows Firewall policy stored in the $WFPobj variable.
PS C:\> $WFPobj=Get-CMWindowsFirewallPolicy -ID "16777568"
PS C:\>Remove-CMWindowsFirewallPolicy -InputObject $WFPobj
Related topics
Set-CMWindowsFirewallPolicy