Share via


Protect-ServerVHDX

Protect-ServerVHDX

Prepares a virtual hard disk to deploy as a hardened virtual machine.

Sintaxis

Parameter Set: PopulateFrom
Protect-ServerVHDX -Certificate <X509Certificate2> -Path <System.String> -PopulateFrom <String> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-TemplateName <String> ] [-Version <Version> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SpecifyVolumeNameAndVersion
Protect-ServerVHDX -Certificate <X509Certificate2> -Path <System.String> -TemplateName <String> -Version <Version> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Descripción detallada

The Protect-ServerVHDX cmdlet prepares a virtual hard disk to deploy as a hardened virtual machine. The virtual hard disk must be in the .vhdx format. This cmdlet overwrites the .vhdx file. You cannot use that file for any other purpose.

Parámetros

-Certificate<X509Certificate2>

Specifies an X509Certificate2 object.

Alias

none

¿Necesario?

true

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-InformationAction<System.Management.Automation.ActionPreference>

Specifies how this cmdlet responds to an information event. Los valores aceptables para este parámetro son:

-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend

Alias

infa

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-InformationVariable<System.String>

Specifies a variable in which to store an information event message.

Alias

iv

¿Necesario?

false

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-Path<System.String>

Specifies the path of the hardened .vhdx file.

Alias

none

¿Necesario?

true

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-PopulateFrom<String>

Specifies the path of a file that contains a previously published volume signature catalog. The file name extension is .vhdx.

Alias

none

¿Necesario?

true

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-TemplateName<String>

Specifies a name for the template.

Alias

none

¿Necesario?

true

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-Version<Version>

Specifies a value that uniquely identifies this version of the template. The version value uses the form a.b.c.d, where each value is an integer less than 65536.

Alias

none

¿Necesario?

true

¿Posición?

named

Valor predeterminado

none

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el cmdlet.

¿Necesario?

false

¿Posición?

named

Valor predeterminado

false

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.

¿Necesario?

false

¿Posición?

named

Valor predeterminado

false

¿Aceptar la entrada de la canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entradas

El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.

  • String, Version, X509Certificate2

Salidas

El tipo de resultado es el tipo de los objetos que el cmdlet emite.

Ejemplos

Example 1: Harden a .vhdx file by populating from a file

This command prepares the .vhdx that the VirtualDiskPath specifies. The command uses the name and version information from Build12VirtualDisk.vhdx. The command specifies the template name Template 22.

PS C:\> Protect-ServerVHDX -Certificate (dir cert:currentuser\my)[0] -PopulateFrom "Build12VirtualDisk.vhdx" -VirtualDiskPath "HardenedVirtualDisk.vhdx" -TemplateName "Template 22" 

Example 2: Harden a .vhdx file by specifying name and verison

This command prepares the .vhdx that the VirtualDiskPath specifies. The command uses the name and version information specified by the TemplateName and Version parameters.

PS C:\> Protect-ServerVHDX -Certificate (dir cert:currentuser\my)[0] -VirtualDiskPath "HardenedVirtualDisk.vhdx" -TemplateName "Template 22" -Version 10.9.8.12