Set-CMEndpointProtectionPoint

Set-CMEndpointProtectionPoint

Modifies a site system role for Endpoint Protection.

Syntax

Parameter Set: SetByName
Set-CMEndpointProtectionPoint -ProtectionService <MapsMembershipType> {AdvancedMembership | BasicMembership | DoNotJoinMaps} -SiteCode <String> -SiteSystemServerName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetByValue
Set-CMEndpointProtectionPoint -InputObject <IResultObject> -ProtectionService <MapsMembershipType> {AdvancedMembership | BasicMembership | DoNotJoinMaps} [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

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

Endpoint Protection lets you manage antimalware policies and Windows Firewall security for client computers in System Center 2012 Configuration Manager. In order to use Endpoint Protection with System Center 2012 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 2012 Configuration Manager, see the Endpoint Protection in Configuration Manager (https://go.microsoft.com/fwlink/?LinkId=268427) on TechNet.

Parameters

-InputObject<IResultObject>

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

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-ProtectionService<MapsMembershipType>

Specifies the type of membership to set for Microsoft Active Protection Service (MAPS). The acceptable values for this parameter are:

-- AdvancedMembership
-- BasicMembership
-- DoNotJoinMaps

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteCode<String>

Specifies the site code for a Configuration Manager site.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByPropertyName)

Accept Wildcard Characters?

false

-SiteSystemServerName<String>

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

Aliases

none

Required?

true

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: Set an endpoint protection point

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

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

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

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.

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

Add-CMEndpointProtectionPoint

Get-CMEndpointProtectionPoint

Remove-CMEndpointProtectionPoint

Endpoint Protection in Configuration Manager