Set-CMEndpointProtectionPoint

Modifies a site system role for Endpoint Protection.

Syntax

Set-CMEndpointProtectionPoint
   -ProtectionService <MapsMembershipType>
   -InputObject <IResultObject>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMEndpointProtectionPoint
   [-SiteCode <String>]
   [-SiteSystemServerName] <String>
   -ProtectionService <MapsMembershipType>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-CMEndpointProtectionPoint cmdlet modifies a site system role for System Center 2016 Endpoint Protection in Microsoft System Center Configuration Manager.

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 the Endpoint Protection in Configuration Manager on TechNet.

Examples

Example 1: Set an endpoint protection point

PS C:\> Set-CMEndpointProtectionPoint -SiteSystemServerName "CM-Contoso.Contoso.Com" -SiteCode "CM2" -ProtectionService AdvancedMembership

The command sets the endpoint protection point for the server, and specifies the membership type for the ProtectionService parameter.

Example 2: Set an endpoint protection point by using an input object

PS C:\> $Epp = Get-CMEndpointProtectionPoint -SiteSystemServerName "CM-Contoso.Contoso.Com" -SiteCode "CM2" 
PS C:\> Set-CMEndpointProtectionPoint -InputObject $Epp -ProtectionService BasicMembership

The first command uses the Get-CMEndpointProtectionPoint cmdlet to get an endpoint protection point, and stores the result in the $Epp variable.

The second command sets the endpoint protection point for the server by using the input object from the previous command.

Required Parameters

-InputObject

Specifies an input object. To obtain an input object, use the Get-CMEndpointProtectionPoint cmdlet.

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

Specifies the type of membership to set for Microsoft Active Protection Service (MAPS). The acceptable values for this parameter 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
-PassThru

Returns the current working object. By default, this cmdlet does not generate any output.

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