Edit

Share via

Get-KeyProtectorFromShieldingDataFile

Module:
ShieldedVMProvisioning Module

Gets the Key Protector from a Shielding Data File.

Syntax

Default (Default) 

Get-KeyProtectorFromShieldingDataFile
    [-ShieldingDataFilePath] <String>
    [<CommonParameters>]

Description

The Get-KeyProtectorFromShieldingDataFile cmdlet gets the Key Protector from a Shielding Data File.

Examples

Example 1: Extract the raw byte form of the Key Protector from the shielding data file

PS C:\>Get-KeyProtectorFromShieldingDataFile -ShieldingDataFilePath "C:\temp\shieldingdata.pdk"
0 0 36 52 [...]

This command extracts the raw byte form of the key protector from the shielding data file located at C:\temp\shieldingdata.pdk

Example 2: Extract the raw key protector from the shielding data and convert it to an HGS Key Protector object

PS C:\>$KP = Get-KeyProtectorFromShieldingDataFile -ShieldingDataFilePath 'C:\temp\shieldingdata.pdk'
PS C:\> ConvertTo-HgsKeyProtector -Bytes $KP

The first command extracts the raw key protector from the shielding data file located at C:\temp\shieldingdata.pdk and stores the result in the variable named $KP.

The second command converts raw key protector stored in the $KB variable to an HGS Key Protector object for further inspection.

Parameters

-ShieldingDataFilePath

Specifies the location of a Shielding Data File (.pdk).

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:1
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

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

Outputs

None

This cmdlet returns a Byte[] array that represents the raw key protector structure.