Edit

Share via

Remove-HgsAttestationHostGroup

  • Reference
Module:
HgsAttestation

Removes an attestation policy based on a host group.

Syntax

Remove-HgsAttestationHostGroup
      [-Name] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Remove-HgsAttestationHostGroup cmdlet removes an attestation policy that is based on the configuration of an Active Directory host group from Host Guardian Service (HGS).

Examples

Example 1: Remove a host group

PS C:\> Remove-HgsAttestationHostGroup -Name "TrustedADHostGroup14"

This command removes the host group named TrustedADHostGroup14 from the Attestation service. If a guarded host belongs to this host group and to no other trusted host group, the host can no longer obtain a new Attestation certificate.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the friendly name of the host group for which this cmdlet removes a policy.

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