Save-CMEndpointProtectionDefinition
Save-CMEndpointProtectionDefinition
Saves an Endpoint Protection definition.
Syntax
Parameter Set: SearchByNameMandatory
Save-CMEndpointProtectionDefinition -DeviceCollectionName <String> [-Device <IResultObject> ] [-DeviceId <String> ] [-DeviceName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByIdMandatory
Save-CMEndpointProtectionDefinition -DeviceCollectionId <String> [-Device <IResultObject> ] [-DeviceId <String> ] [-DeviceName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SearchByValueMandatory
Save-CMEndpointProtectionDefinition -DeviceCollection <IResultObject> [-Device <IResultObject> ] [-DeviceId <String> ] [-DeviceName <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Save-CMEndpointProtectionDefinition cmdlet saves a System Center 2012 Endpoint Protection definition in Microsoft System Center 2012 SP1 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 (https://go.microsoft.com/fwlink/?linkid=268427) on TechNet.
Parameters
-Device<IResultObject>
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.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeviceCollection<IResultObject>
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.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeviceCollectionId<String>
Specifies an ID for a Configuration Manager device collection to which you add the Endpoint Protection definition.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeviceCollectionName<String>
Specifies a name for a Configuration Manager device collection to which you add the Endpoint Protection definition.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeviceId<String>
Specifies the ID of a Configuration Manager device to which you add the Endpoint Protection definition.
Aliases |
ResourceID |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeviceName<String>
Specifies the name of a Configuration Manager device to which you save the Endpoint Protection definition.
Aliases |
Name |
Required? |
false |
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: Save an Endpoint Protection definition by using a device collection name
This command saves the Endpoint Protection definition to the devices in the device collection named NA-Client-Devices.
PS C:\> Save-CMEndpointProtectionDefinition -DeviceCollectionName "NA-Client-Devices"