Compartilhar via

New-SCVMShieldingData

  • Referência
Módulo:
VirtualMachineManager

Cria um objeto de dados de blindagem de máquina virtual de um arquivo .pdk.

Sintaxe

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

O cmdlet New-SCVMShieldingData cria um objeto VMShieldingData de um blob de provisionamento seguro, um arquivo .pdk, no VMM (Virtual Machine Manager). Esse arquivo inclui informações como chaves de propriedade de máquina virtual, informações de personalização de máquina virtual, hashes de chaves de origem aceitáveis e outras informações. Os locatários criam um blob de provisionamento usando uma ferramenta fora de banda.

Você pode usar um objeto de dados de blindagem de máquina virtual para tarefas como criptografar TPMs (Virtual Trusted Platform Modules), criar máquinas virtuais blindadas e usar máquinas virtuais não blindadas.

O banco de dados do VMM gerencia objetos de dados de blindagem de máquina virtual como um recurso de biblioteca. Elas têm o escopo adequado para a função de usuário associada. O VMM fornece funcionalidade de criar, ler, atualizar e excluir para gerenciá-los.

Exemplos

Exemplo 1: criar uma máquina virtual blindando dados usando um arquivo .pdk

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

Esse comando cria um objeto de dados de blindagem de máquina virtual chamado ShieldingData01. O comando baseia o objeto no arquivo SD.pdk que o parâmetro VMShieldingDataPath especifica.

Exemplo 2: Criar uma máquina virtual blindando dados usando dados brutos

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

O primeiro comando armazena o conteúdo de SD.pdf como uma matriz de bytes para a variável $Bytes.

Esse comando cria um objeto de dados de blindagem de máquina virtual chamado ShieldingData02. O comando baseia o objeto na matriz $Bytes especificada pelo parâmetro RawData.

Parâmetros

-Description

Especifica uma descrição para o objeto VMShieldingData.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

Especifica o nome de uma variável na qual o progresso do trabalho é acompanhado e armazenado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica um nome para o objeto VMShieldingData.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RawData

Especifica uma matriz de bytes que contêm dados .pdk brutos.

Tipo:Byte[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMShieldingDataPath

Especifica o caminho de um arquivo .pdk.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

VMShieldingData

Esse cmdlet retorna um objeto de dados de blindagem de máquina virtual que contém as seguintes informações:

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Nome
  • Descrição