New-CMAntimalwarePolicy

Creates an object that specifies antimalware policies.

Syntax

New-CMAntimalwarePolicy
   -Name <String>
   [-Description <String>]
   -Policy <PolicyType[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-CMAntimalwarePolicy cmdlet creates an object that specifies the antimalware policies for System Center 2016 Endpoint Protection that apply to collections of client computers that run a Microsoft System Center Configuration Manager agent. Antimalware policies are configuration settings that define how an antimalware agent operates on a client computer.

Examples

Example 1: Create an antimalware policy

PS C:\> New-CMAntimalwarePolicy -Name "ExclusionsPolicy" -Policy ExclusionSettings -Description "Policy defining exclusions."

This command creates an antimalware policy named ExclustionsPolicy. This policy has the policy type of ExclusionSettings. The command includes an optional description that describes the policy.

Required Parameters

-Name

Specifies a name for the policy.

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

Specifies an array of antimalware policy types. The acceptable values for this parameter are:

  • Advanced
  • DefaultActions
  • DefinitionUpdates
  • ExclusionSettings
  • MicrosoftActiveProtectionService
  • RealTimeProtection
  • ScanSettings
  • ScheduledScans
  • ThreatOverrides
Type:PolicyType[]
Parameter Sets:ScheduledScans, ScanSettings, DefaultActions, RealTimeProtection, ExclusionSettings, Advanced, ThreatOverrides, MicrosoftActiveProtectionService, DefinitionUpdates
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
-Description

Specifies a description for the policy.

Type:String
Position:Named
Default value:None
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