Remove-CMSystemHealthValidationPoint

Applies To: System Center 2012 Configuration Manager SP1

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

Remove-CMSystemHealthValidationPoint

Removes a system health validation point from Configuration Manager.

Syntax

Parameter Set: SearchByNameMandatory
Remove-CMSystemHealthValidationPoint -SiteCode <String> -SiteSystemServerName <String> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SearchByValueMandatory
Remove-CMSystemHealthValidationPoint -InputObject <IResultObject> [-Force] [-Confirm] [-WhatIf] [ <CommonParameters>]

Detailed Description

The Remove-CMSystemHealthValidationPoint cmdlet removes a system health validation point from a Microsoft System Center 2012 Configuration Manager site. This site system role validates statements of health from a server that is running Network Policy Server (NPS). You can specify a validation point by site system name or site code or both or you can use the Get-CMSystemHealthValidationPoint cmdlet.

Before you remove a system health validation point, make sure that there is another system health validator point for the site, or that the server that is running NPS has policies that grant network access and do not reference the System Center 2012 Configuration Manager.

Parameters

-Force

Removes a system health validation point without prompting you for confirmation. By default, the cmdlet prompts you for confirmation before it proceeds.

-InputObject<IResultObject>

Specifies a system health validation point object. To obtain a system health validation point object, use the Get-CMSystemHealthValidationPoint cmdlet.

-SiteCode<String>

Specifies a site code for a Configuration Manager site.

-SiteSystemServerName<String>

Specifies the host name for a system health validation point.

-Confirm

Prompts you for confirmation before executing the command.

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

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: Remove a validation point

This command removes a system health validation point. The command specifies the site code and the name of the server that hosts that system role.

PS C:\> Remove-CMSystemHealthValidationPoint -SiteCode "CM1" -SiteSystemServerName "SHVP07.Western.Contoso.com" 

Example 2: Remove a validation point by using a variable

This example removes a system health validation point.

The first command gets the system role that has the specified site code and host name and stores it in the $CMSHVP variable.

The second command removes the system health validation point stored in the $CMSHVP variable.

PS C:\> $CMSHVP = Get-CMSystemHealthValidationPoint -SiteCode "CM1" -SiteSystemServerName "SHVP07.Western.Contoso.com" 
PS C:\> Remove-CMSystemHealthValidationPoint -InputObject $CMSHVP

Related topics

Get-CMSystemHealthValidationPoint