Partilhar via

New-SCVMShieldingData

  • Referência
Módulo:
VirtualMachineManager

Cria um objeto de dados de proteção 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 a partir de um blob de provisionamento seguro, um arquivo .pdk, no Virtual Machine Manager (VMM). Esse arquivo inclui informações como chaves de propriedade da máquina virtual, informações de personalização da 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 proteção de máquina virtual para tarefas como criptografar TPMs (Trusted Platform Modules) virtuais, criar máquinas virtuais blindadas e criar máquinas virtuais não blindadas.

O banco de dados do VMM gerencia objetos de dados de proteção de máquina virtual como um recurso de biblioteca. Eles têm um escopo apropriado para a função de usuário associada. O VMM fornece funcionalidades de criação, leitura, atualização e exclusão para gerenciá-los.

Exemplos

Exemplo 1: Criar uma máquina virtual protegendo dados usando um arquivo .pdk

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

Este 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 protegendo 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.

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

Parâmetros

-Description

Especifica uma descrição para o VMShieldingData objeto.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica um nome para o VMShieldingData objeto.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

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

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RawData

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

Tipo:Byte[]
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMShieldingDataPath

Especifica o caminho de um arquivo .pdk.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Saídas

VMShieldingData

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

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardiões
  • Designação
  • Descrição