New-CMAntimalwarePolicy

SYNOPSIS

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.

PARAMETERS

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-Description

Specifies a description for the policy.

Type: String
Parameter Sets: (All)
Aliases: 

Required: False
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
Parameter Sets: (All)
Aliases: 

Required: False
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
Parameter Sets: (All)
Aliases: 

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

-Name

Specifies a name for the policy.

Type: String
Parameter Sets: (All)
Aliases: 

Required: True
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: (All)
Aliases: 
Accepted values: ScheduledScans, ScanSettings, DefaultActions, RealTimeProtection, ExclusionSettings, Advanced, ThreatOverrides, MicrosoftActiveProtectionService, DefinitionUpdates

Required: True
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
Parameter Sets: (All)
Aliases: wi

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).

INPUTS

OUTPUTS

NOTES

Export-CMAntimalwarePolicy

Get-CMAntiMalwarePolicy

Merge-CMAntimalwarePolicy

Remove-CMAntiMalwarePolicy

Set-CMAntiMalwarePolicy

Start-CMAntimalwarePolicyDeployment