Get-HgsTraceFileData
Gets metadata about and the contents of HGS Diagnostic trace files recorded in a trace manifest.
Syntax
Get-HgsTraceFileData
-File <String>
-Manifest <String>
-StartByte <Int64>
[<CommonParameters>]
Get-HgsTraceFileData
-File <String>
-Manifest <String>
[-Length]
[<CommonParameters>]
Description
The Get-HgsTraceFileData cmdlet gets segments of Host Guardian Service (HGS) Diagnostic trace files recorded in a trace file manifest generated by Get-HgsTrace, as well as length information. This cmdlet is utilized by the Get-HgsTrace cmdlet to securely get trace files over a Windows PowerShell® remote session that does not expose other portions of the file system.
Examples
Example 1: Get the length of a trace file
PS C:\> Get-TraceFileData -File "Certificates.xml" -Manifest "Traces.xml" -Length
This command gets the length of the file named Certificates.xml file found in the Traces.xml manifest.
Example 2: Get a segment of a trace file contained in a manifest
PS C:\> Get-TraceFileData -File "Logs.evtx" -Manifest "Traces.xml" -StartByte 1024
This command gets a segment, in bytes, from the file named Logs.evtx if it is found in the Traces.xml manifest. If the file is not found in the manifest, this cmdlet returns an error.
Parameters
-File
Specifies the full path of the file that you wish to query. The file must be in the manifest specified in the Manifest parameter.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Length
Indicates that this cmdlet gets the total length, in bytes, of the trace file, instead of a data segment.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Manifest
Specifies the path to the manifest file that documents the trace file specified in the File parameter.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StartByte
Specifies the starting byte from which this cmdlet gets a segment of the trace file's data. This value must be greater than 0 but less than the total length of the requested file.
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Outputs
System.Int64,System.Byte[]