Remove-CMSystemHealthValidatorPoint

Removes a system health validator point from Configuration Manager.

Syntax

Remove-CMSystemHealthValidatorPoint
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMSystemHealthValidatorPoint
      [-SiteCode <String>]
      [-Force]
      [-SiteSystemServerName] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Remove-CMSystemHealthValidatorPoint cmdlet removes a system health validator point from a Microsoft System Center 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 validator point by site system name or site code or both or you can use the Get-CMSystemHealthValidatorPoint cmdlet.

Before you remove a system health validator 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 Configuration Manager.

Examples

Example 1: Remove a validator point

PS C:\> Remove-CMSystemHealthValidatorPoint -SiteCode "CM1" -SiteSystemServerName "Test01.TSQA.Contoso.com"

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

Example 2: Remove a validator point by using a variable

PS C:\> $CMSHVP = Get-CMSystemHealthValidatorPoint -SiteCode "CM1" -SiteSystemServerName "Test01.TSQA.Contoso.com" 
PS C:\> Remove-CMSystemHealthValidatorPoint -InputObject $CMSHVP

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 validator point stored in the $CMSHVP variable.

Required Parameters

-InputObject

Specifies a system health validator point object. To obtain a system health validator point object, use Get-CMSystemHealthValidatorPoint.

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

Specifies the host name for a system health validator point.

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

Indicates that wildcard handling is disabled.

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

Forces the command to run without asking for user confirmation.

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

Indicates that wildcard handling is enabled.

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

Specifies a 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