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.

Required Parameters

-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
Accept pipeline input: False
Accept wildcard characters: False
-VM

Specifies the virtual machine that this cmdlet provisions.

Type: VirtualMachine
Position: 3
Default value: None
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
Accept pipeline input: False
Accept wildcard characters: False

Optional 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
Accept pipeline input: False
Accept wildcard characters: False

Outputs

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