Merge-CMAntimalwarePolicy

Merges antimalware policies for Endpoint Protection.

Syntax

Merge-CMAntimalwarePolicy
     -BasePolicyId <String>
     -OtherPolicyId <String[]>
     -NewPolicyName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Merge-CMAntimalwarePolicy
     -BasePolicyName <String>
     -OtherPolicyName <String[]>
     -NewPolicyName <String>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

The Merge-CMAntimalwarePolicy cmdlet merges two or more existing antimalware policies for System Center 2016 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.

Examples

Example 1: Merge antimalware policies

PS C:\>Merge-CMAntimalwarePolicy -BasePolicyName "ContosoPolicy" -NewPolicyName "ContosoPolicy2013" -OtherPolicyName "ContosoPoliciesNewFor2013"

This command 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.

Required Parameters

-BasePolicyId

Specifies the antimalware policy that this cmdlet merges with other policies by using an ID.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-BasePolicyName

Specifies the antimalware policy that this cmdlet merges with other policies by using a name.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-NewPolicyName

Specifies the name of the new antimalware policy that contains the merged policies.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OtherPolicyId

Specifies an array of policies that this cmdlet merges with the base policy by using the policy IDs.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-OtherPolicyName

Specifies an array of policies that this cmdlet merges with the base policy by using the policy names.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

DisableWildcardHandling treats wildcard characters as literal character values. Cannot be combined with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

ForceWildcardHandling processes wildcard characters and may lead to unexpected behavior (not recommended). Cannot be combined with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False