Get-CMAntimalwarePolicy

SYNOPSIS

Gets antimalware policies for Endpoint Protection.

SYNTAX

SearchByName (Default)

Get-CMAntimalwarePolicy [-Name <String>] [-Policy <PolicyType[]>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

SearchByIdMandatory

Get-CMAntimalwarePolicy -Id <String> [-Policy <PolicyType[]>] [-DisableWildcardHandling]
 [-ForceWildcardHandling] [<CommonParameters>]

DESCRIPTION

The Get-CMAntiMalwarePolicy cmdlet gets the antimalware policies for System Center 2016 Endpoint Protection that apply to collections of client computers that are running the Microsoft System Center Configuration Manager agent. Antimalware policies are configuration settings that define how an antimalware agent operates on client computers.

EXAMPLES

Example 1: Get all antimalware policies

PS C:\> Get-CMAntiMalwarePolicy

This command gets all antimalware policies for Endpoint Protection in Configuration Manager.

Example 2: Get antimalware policies by using a wildcard character

PS C:\> Get-CMAntiMalwarePolicy -Name "D*"

This command gets antimalware policies that have a name that begins with the letter D.

Example 3: Get antimalware policies by using an object ID

PS C:\> Get-CMAntiMalwarePolicy -Id "16777217"

This command gets the antimalware policy that has the ID 16777217.

PARAMETERS

-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

-Id

Specifies the ID of an antimalware policy object.

Type: String
Parameter Sets: SearchByIdMandatory
Aliases: SettingsId

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

-Name

Specifies the name of an antimalware policy.

Type: String
Parameter Sets: SearchByName
Aliases: 

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

-Policy

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

  • Advanced
  • DefaultActions
  • DefinitionUpdates
  • ExclusionSettings
  • MicrosoftActiveProtectionService
  • RealTimeProtection
  • ScanSettings
  • ThreatOverrides
Type: PolicyType[]
Parameter Sets: (All)
Aliases: 
Accepted values: ScheduledScans, ScanSettings, DefaultActions, RealTimeProtection, ExclusionSettings, Advanced, ThreatOverrides, MicrosoftActiveProtectionService, DefinitionUpdates

Required: False
Position: Named
Default value: None
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

New-CMAntimalwarePolicy

Set-CMAntiMalwarePolicy

Export-CMAntimalwarePolicy

Import-CMAntimalwarePolicy

Merge-CMAntimalwarePolicy

Remove-CMAntiMalwarePolicy