Get-HgsAttestationTpmHost

Gets guarded hosts with TPM 2.0 from the Attestation service HGS.

Syntax

Get-HgsAttestationTpmHost
   [-Name <String>]
   [<CommonParameters>]
Get-HgsAttestationTpmHost
   -Path <String>
   [<CommonParameters>]
Get-HgsAttestationTpmHost
   -Xml <XmlDocument>
   [<CommonParameters>]

Description

The Get-HgsAttestationTpmHost cmdlet retrieves guarded hosts from the Attestation service in the Host Guardian Service (HGS). Use this cmdlet for hosts that have trusted platform module (TPM) 2.0 hardware, and that were added by using the Add-HgsAttestationTpmHost cmdlet.

Required Parameters

-Path

Specifies the full path of an .xml file for which this cmdlet gets hosts. Create this file by using the Get-PlatformIdentifier cmdlet. For more information, type Get-Help Get-PlatformIdentifier.

Type:String
Aliases:FilePath
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Xml

Specifies the full path of an .xml file that contains binary data for which this cmdlet gets hosts. Create this file by using Get-PlatformIdentifier.

Type:XmlDocument
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False

Optional Parameters

-Name

Specifies the friendly name of the guarded host that this cmdlet gets from the Attestation service.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

String[]

This cmdlet returns an array of strings.