Save-CMEndpointProtectionDefinition

SYNOPSIS

Saves an Endpoint Protection definition.

SYNTAX

SearchByValueMandatory (Default)

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

SearchByNameMandatory

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

SearchByIdMandatory

Save-CMEndpointProtectionDefinition [-DeviceName <String>] [-DeviceId <String>] [-Device <IResultObject>]
 -DeviceCollectionId <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.

PARAMETERS

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

Required: False
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
Parameter Sets: (All)
Aliases: 

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
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
Parameter Sets: SearchByValueMandatory
Aliases: 

Required: True
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
Parameter Sets: SearchByIdMandatory
Aliases: 

Required: True
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
Parameter Sets: SearchByNameMandatory
Aliases: 

Required: True
Position: Named
Default value: None
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
Parameter Sets: (All)
Aliases: ResourceID

Required: False
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
Parameter Sets: (All)
Aliases: Name

Required: False
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
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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

Endpoint Protection in Configuration Manager

Add-CMEndpointProtectionPoint

Get-CMEndpointProtectionPoint

Remove-CMEndpointProtectionPoint

Get-CMDevice

Get-CMDeviceCollection