Save-CMEndpointProtectionDefinition

Saves an Endpoint Protection definition.

Syntax

Save-CMEndpointProtectionDefinition
    [-DeviceName <String>]
    [-DeviceId <String>]
    [-Device <IResultObject>]
    -DeviceCollection <IResultObject>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-CMEndpointProtectionDefinition
    [-DeviceName <String>]
    [-DeviceId <String>]
    [-Device <IResultObject>]
    -DeviceCollectionId <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-CMEndpointProtectionDefinition
    [-DeviceName <String>]
    [-DeviceId <String>]
    [-Device <IResultObject>]
    -DeviceCollectionName <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

The Save-CMEndpointProtectionDefinition cmdlet saves a System Center 2016 Endpoint Protection definition in Microsoft System Center Configuration Manager. Endpoint Protection definitions contain anti-malware policies and settings for Windows Firewall that you can apply to specific groups of computers.

For more information about Endpoint Protection, see Endpoint Protection in Configuration Manager on TechNet.

Examples

Example 1: Save an Endpoint Protection epshort definition by using a device collection nameepshortEndpoint Protection

PS C:\> Save-CMEndpointProtectionDefinition -DeviceCollectionName "NA-Client-Devices"

This command saves the Endpoint Protection definition to the devices in the device collection named NA-Client-Devices.

Required Parameters

-DeviceCollection

Specifies a device collection object in Configuration Manager. To obtain a device collection object, use the Get-CMDeviceCollection cmdlet. This object identifies the device collection to which you save the Endpoint Protection definition.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-DeviceCollectionId

Specifies an ID for a Configuration Manager device collection to which you add the Endpoint Protection definition.

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

Specifies a name for a Configuration Manager device collection to which you add the Endpoint Protection definition.

Type:String
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
-Device

Specifies a device object in Configuration Manager. To obtain a device object, use the Get-CMDevice cmdlet. This object identifies the device to which you save the Endpoint Protection definition.

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-DeviceId

Specifies the ID of a Configuration Manager device to which you add the Endpoint Protection definition.

Type:String
Aliases:ResourceID
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DeviceName

Specifies the name of a Configuration Manager device to which you save the Endpoint Protection definition.

Type:String
Aliases:Name
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