Add-CMEndpointProtectionPoint

Adds a site system role for Endpoint Protection.

Syntax

Add-CMEndpointProtectionPoint
   [-LicenseAgreed <Boolean>]
   -ProtectionService <MapsMembershipType>
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMEndpointProtectionPoint
   [-SiteSystemServerName] <String>
   [-SiteCode <String>]
   [-LicenseAgreed <Boolean>]
   -ProtectionService <MapsMembershipType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Add-CMEndpointProtectionPoint cmdlet adds a site system role for System Center 2016 Endpoint Protection to a Microsoft System Center Configuration Manager site.

Endpoint Protection lets you manage antimalware policies and Windows Firewall security for client computers in System Center Configuration Manager. In order to use Endpoint Protection with System Center Configuration Manager, you must install a single site system role for Endpoint Protection, either in the central site or in a stand-alone primary site. For more information about Endpoint Protection in System Center Configuration Manager, see Endpoint Protection in Configuration Manager on TechNet.

Examples

Example 1: Add a site system role

PS C:\>Add-CMEndpointProtectionPoint -LicenseAgreed $True -ProtectionService BasicMembership -SiteCode "CM1" -SiteSystemServerName "CMEPPoint.Western.Contoso.com"

This command adds an Endpoint Protection point for the site that has the site code CM1. The specified computer hosts the role. The command also specifies that you accept the terms of the license agreement and have a basic membership for Endpoint Protection.

Required Parameters

-InputObject

Specifies the input to this cmdlet. You can use this parameter, or you can pipe the input to this cmdlet.

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

Specifies the type of membership you have for Microsoft Active Protection Service (MAPS). Valid values are:

  • AdvancedMembership
  • BasicMembership
  • DoNotJoinMaps
Type:MapsMembershipType
Parameter Sets:DoNotJoinMaps, BasicMembership, AdvancedMembership
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteSystemServerName

Specifies the name of a server that hosts a site system role.

Type:String
Aliases:Name, ServerName
Position:0
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
-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
-LicenseAgreed

Specifies whether you agree to the Endpoint Protection software licensing terms.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-SiteCode

Specifies the site code for a Configuration Manager site.

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