Initialize-ShieldedVM
Provisions a Shielded virtual machine.
Syntax
ByVM
Initialize-ShieldedVM
[-ShieldingDataFilePath] <String>
[[-ShieldedVMSpecializationDataFilePath] <String>]
[-VM] <VirtualMachine>
[<CommonParameters>]
ByName
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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ShieldingDataFilePath
Specifies the location of a shielding data file (.pdk) used to configure and specialize the virtual machine.
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 |
-VM
Specifies the virtual machine that this cmdlet provisions.
Parameter properties
| Type: | VirtualMachine |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ByVM
| Position: | 3 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VMName
Specifies the name of the virtual machine that this cmdlet provisions.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
ByName
| Position: | 3 |
| 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
undefined
This cmdlet returns a CimInstance object that represents the provisioning job for the shielded virtual machine.