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 this cmdlet merges 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 this cmdlet merges 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 that this cmdlet merges 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 that this cmdlet merges 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 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.

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

Export-CMAntimalwarePolicy

Get-CMAntiMalwarePolicy

Import-CMAntimalwarePolicy

New-CMAntimalwarePolicy

Remove-CMAntiMalwarePolicy

Set-CMAntiMalwarePolicy