Add-CMEndpointProtectionPoint

Adds a site system role for Endpoint Protection.

Syntax

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

Description

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

Endpoint Protection lets you manage antimalware policies and Windows Firewall security for client computers in Configuration Manager. In order to use Endpoint Protection with 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 Configuration Manager, 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: Add a site system role

PS XYZ:\>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.

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

-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

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

-LicenseAgreed

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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
Accepted values:DoNotJoinMaps, BasicMembership, AdvancedMembership
Position:Named
Default value:None
Required:True
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
Required:False
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
Required:True
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

IResultObject