Clear-HgsServer

Resets the Host Guardian Service on the local node to the uninitialized state.

Syntax

Clear-HgsServer
     [[-ClusterName] <String>]
     [-Force]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

The Clear-HgsServer cmdlet removes a local node from the Host Guardian Service (HGS).

This cmdlet makes the following infrastructure component changes on the additional HGS node:

This cmdlet makes the following infrastructure components changes on the last HGS node:

For more information about the scenario terms, see Security and Assurance.

Examples

Example 1: Clear all cluster initialization settings from the local node

PS C:\> Clear-HgsServer

This command returns the HGS Server on the local node to a clean state to prepare it for the Initialize-HgsServer command.

Example 2: Clear all cluster initialization settings from the local node without confirmation

PS C:\> Clear-HgsServer -Force -Confirm:$False

This command returns the HGS Server on the local node to a clean state to prepare it for the Initialize-HgsServer command and does not prompt for confirmation.

Optional Parameters

-ClusterName

Specifies a cluster name.

Type:String
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-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
-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
-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