Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Remove-HgsAttestationHostGroup

Brian Lich|Last Updated: 3/29/2017

SYNOPSIS

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
Parameter Sets: (All)
Aliases: cf

Required: False
Position: Named
Default value: 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
Parameter Sets: (All)
Aliases: 

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

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

INPUTS

OUTPUTS

NOTES

Add-HgsAttestationHostGroup

Get-HgsAttestationHostGroup

© 2017 Microsoft