Edit

Share via

Merge-CMAntimalwarePolicy

  • Reference
Module:
ConfigurationManager

Merges antimalware policies for Endpoint Protection.

Syntax

Merge-CMAntimalwarePolicy
     -BasePolicyId <String>
     -NewPolicyName <String>
     -OtherPolicyId <String[]>
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Merge-CMAntimalwarePolicy
     -BasePolicyName <String>
     -NewPolicyName <String>
     -OtherPolicyName <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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Merge antimalware policies

PS XYZ:\>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.

Parameters

-BasePolicyId

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

Type:String
Position:Named
Default value:None
Required:True
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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:True
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
Required:True
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
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

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

Inputs

None

Outputs

System.Object