Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
182 lines (138 sloc) 4.62 KB

<<<<<<< HEAD

title: Get-CMAntimalwarePolicy titleSuffix: Configuration Manager description: Gets antimalware policies for Endpoint Protection. ms.date: 05/01/2019 ms.prod: configuration-manager ms.technology: configmgr-other ms.topic: conceptual author: aczechowski ms.author: aaroncz manager: dougeby

--- external help file: AdminUI.PS.EP.dll-Help.xml ms.assetid: 7C3ACB22-60BF-4E15-816C-ED53B126D10F online version: https://go.microsoft.com/fwlink/?linkid=834080 schema: 2.0.0

master


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

[!NOTE] Configuration Manager CmdLets must be run from the Configuration Manager site drive. For more information, see the getting started documentation.

Example 1: Get all antimalware policies

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

RELATED LINKS

New-CMAntimalwarePolicy

Set-CMAntiMalwarePolicy

Export-CMAntimalwarePolicy

Import-CMAntimalwarePolicy

Merge-CMAntimalwarePolicy

Remove-CMAntiMalwarePolicy

You can’t perform that action at this time.