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