Set-CMEndpointProtectionPoint

Modifies a site system role for Endpoint Protection.

Syntax

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

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
Required:True
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
Required:True
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
Required:True
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
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False
-DisableWildcardHandling

Indicates that wildcard handling is disabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ForceWildcardHandling

Indicates that wildcard handling is enabled.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PassThru

Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.

Type:SwitchParameter
Required:False
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
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
Aliases:wi
Required:False
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False