New-SCVMShieldingData

  • Referencia
Módulo:
VirtualMachineManager

Crea un objeto de datos de blindaje de máquinas virtuales a partir de un archivo .pdk.

Sintaxis

New-SCVMShieldingData
   [-VMMServer <ServerConnection>]
   -VMShieldingDataPath <String>
   -Name <String>
   [-Description <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
New-SCVMShieldingData
   [-VMMServer <ServerConnection>]
   -RawData <Byte[]>
   -Name <String>
   [-Description <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

El cmdlet New-SCVMShieldingData crea un objeto VMShieldingData a partir de un blob de aprovisionamiento seguro, un archivo .pdk, en Virtual Machine Manager (VMM). Este archivo incluye información como claves de propiedad de máquina virtual, información de personalización de máquina virtual, hashes de claves de origen aceptables y otra información. Los inquilinos crean un blob de aprovisionamiento mediante una herramienta fuera de banda.

Puede usar un objeto de datos de blindaje de máquinas virtuales para tareas como cifrar módulos de plataforma segura (TPM) virtuales virtuales, crear máquinas virtuales blindadas y máquinas virtuales no blindadas.

La base de datos VMM administra objetos de datos de blindaje de máquinas virtuales como un recurso de biblioteca. Tienen el ámbito adecuado para el rol de usuario asociado. VMM proporciona funcionalidades de creación, lectura, actualización y eliminación para administrarlas.

Ejemplos

Ejemplo 1: Creación de datos de blindaje de máquinas virtuales mediante un archivo .pdk

PS C:\> New-SCVMShieldingData -Name "ShieldingData01" -Description "Shielding data" -VMShieldingDataPath "C:\virtual\SD.pdk"

Este comando crea un objeto de datos de blindaje de máquina virtual denominado ShieldingData01. El comando basa el objeto en el archivo SD.pdk que especifica el parámetro VMShieldingDataPath.

Ejemplo 2: Creación de datos de blindaje de máquinas virtuales mediante datos sin procesar

PS C:\> $Bytes = [System.IO.File]::ReadAllBytes ("C:\virtual\SD.pdk")
PS C:\> New-SCVMShieldingData -Name "ShieldingData02" -Description "Shielding data" -RawData $Bytes

El primer comando almacena el contenido de SD.pdf como una matriz de bytes en la variable $Bytes.

Este comando crea un objeto de datos de blindaje de máquina virtual denominado ShieldingData02. El comando basa el objeto en la matriz $Bytes que especifica el parámetro RawData.

Parámetros

-Description

Especifica una descripción del objeto VMShieldingData.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica el nombre de una variable en la que se realiza un seguimiento del progreso del trabajo y se almacena.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica un nombre para el objeto de VMShieldingData.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole. Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RawData

Especifica una matriz de bytes que contienen datos .pdk sin procesar.

Tipo:Byte[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMShieldingDataPath

Especifica la ruta de acceso de un archivo .pdk.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

VMShieldingData

Este cmdlet devuelve un objeto de datos de blindaje de máquina virtual que contiene la siguiente información:

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Nombre
  • Descripción