Merge-CMAntimalwarePolicy
Merge-CMAntimalwarePolicy
Merges antimalware policies for Endpoint Protection.
Syntax
Parameter Set: MergePolicyById
Merge-CMAntimalwarePolicy -BasePolicyId <String> -NewPolicyName <String> -OtherPolicyId <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: MergePolicyByName
Merge-CMAntimalwarePolicy -BasePolicyName <String> -NewPolicyName <String> -OtherPolicyName <String[]> [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Merge-CMAntimalwarePolicy cmdlet merges two or more existing antimalware policies for System Center 2012 Endpoint Protection. This cmdlet can help you consolidate antimalware policies to reduce the number of policies that you manage.
When you merge antimalware policies, the merge operation considers the priority you have configured for each antimalware policy. If two settings conflict, the highest-priority option takes precedence. A merge operation also merges some settings, such as exclusion lists from different antimalware policies.
Parameters
-BasePolicyId<String>
Specifies the antimalware policy that you are merging with other policies by using an ID.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BasePolicyName<String>
Specifies the antimalware policy that you are merging with other policies by using a name.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-NewPolicyName<String>
Specifies the name of the new antimalware policy that contains the merged policies.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OtherPolicyId<String[]>
Specifies an array of policies to merge with the base policy by using the policy IDs.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OtherPolicyName<String[]>
Specifies an array of policies to merge with the base policy by using the policy names.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
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 (https://go.microsoft.com/fwlink/p/?LinkID=113216).
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: Merge antimalware policies
This example merges the antimalware policies in the array named ContosoPoliciesNewFor2013 with an existing antimalware policy named ContosoPolicy. The cmdlet gives the name ContosoPolicy2013 to the merged policy.
PS C:\> Merge-CMAntimalwarePolicy -BasePolicyName "ContosoPolicy" -NewPolicyName "ContosoPolicy2013" -OtherPolicyName "ContosoPoliciesNewFor2013"