New-CMAntimalwarePolicy
New-CMAntimalwarePolicy
Creates an object that specifies antimalware policies.
Syntax
Parameter Set: New
New-CMAntimalwarePolicy -Name <String> -Policy {Advanced | DefaultActions | DefinitionUpdates | ExclusionSettings | MicrosoftActiveProtectionService | RealTimeProtection | ScanSettings | ScheduledScans | ThreatOverrides}[] [-Description <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The New-CMAntimalwarePolicy cmdlet creates an object that specifies the antimalware policies for a Microsoft System Center 2012 Endpoint Protection that apply to collections of client computers that run a Microsoft System Center 2012 Configuration Manager agent. Antimalware policies are configuration settings that define how an antimalware agent operates on a client computer.
Parameters
-Description<String>
Specifies a description for the policy.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String>
Specifies a name for the policy.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Policy<PolicyType[]>
Specifies an array of antimalware policy types.
Acceptable values for this parameter are:
-- Advanced
-- DefaultActions
-- DefinitionUpdates
-- ExclusionSettings
-- MicrosoftActiveProtectionService
-- RealTimeProtection
-- ScanSettings
-- ScheduledScans
-- ThreatOverrides
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: Create an antimalware policy
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.
PS C:\> New-CMAntimalwarePolicy -Name "ExclusionsPolicy" -Policy ExclusionSettings -Description "Policy defining exclusions."