Save-CMEndpointProtectionDefinition

Saves an Endpoint Protection definition.

Syntax

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

Description

The Save-CMEndpointProtectionDefinition cmdlet saves a System Center 2016 Endpoint Protection definition in 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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

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

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

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

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-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
Required:True
Accept pipeline input:True
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
Required:True
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
Required:True
Accept pipeline input:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Outputs

System.Object