Initialize-ShieldedVM

Provisions a Shielded virtual machine.

Syntax

Initialize-ShieldedVM
          [-ShieldingDataFilePath] <String>
          [[-ShieldedVMSpecializationDataFilePath] <String>]
          [-VM] <VirtualMachine>
          [<CommonParameters>]
Initialize-ShieldedVM
          [-ShieldingDataFilePath] <String>
          [[-ShieldedVMSpecializationDataFilePath] <String>]
          [-VMName] <String>
          [<CommonParameters>]

Description

The Initialize-ShieldedVM cmdlet provisions a shielded virtual machine.

Examples

Example 1: Provision a Shielded virtual machine

PS C:\>Initialize-ShieldedVM -ShieldingDataFilePath "C:\temp\Tenant01-Shielded.pdk" -ShieldedVMSpecializationDataFilePath "C:\temp\Tenant01-VM01.fsk" -VMName "VM01"

This command starts provisioning the virtual machine named VM01 on the local system using the shielding data file at C:\temp\Tenant01-Shielded.pdk and substituting values from the specialization file at C:\temp\Tenant01-VM01.fsk.

Example 2: Provision a Shielded virtual machine that is stored in a variable

PS C:\>Initialize-ShieldedVM -ShieldingDataFilePath "C:\temp\Tenant01-Shielded.pdk" -ShieldedVMSpecializationDataFilePath "C:\temp\Tenant01-VM01.fsk" -VirtualMachine $VM

This command starts provisioning the virtual machine stored in the variable named $VM that uses the shielding data file at C:\temp\Tenant01-Shielded.pdk and substitutes values from the specialization file at C:\temp\Tenant01-VM01.fsk.

Parameters

-ShieldedVMSpecializationDataFilePath

Specifies the location of a specialization data file (.fsk) used to substitute values in the specialization phase of the shielded virtual machine.

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

-ShieldingDataFilePath

Specifies the location of a shielding data file (.pdk) used to configure and specialize the virtual machine.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VM

Specifies the virtual machine that this cmdlet provisions.

Type:VirtualMachine
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMName

Specifies the name of the virtual machine that this cmdlet provisions.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Outputs

CimInstance

This cmdlet returns a CimInstance object that represents the provisioning job for the shielded virtual machine.