Compartilhar via


New-SCVMShieldingData

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

Sintaxe

VMShieldingDataFromPath (Padrão)

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

VMShieldingDataFromBytes

New-SCVMShieldingData
    -RawData <Byte[]>
    -Name <String>
    [-VMMServer <ServerConnection>]
    [-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 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 blindagem de máquina virtual para tarefas como criptografar TPMs (Trusted Platform Modules) virtuais, criar máquinas virtuais blindadas e proteger 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. Eles têm o escopo adequado para a função de usuário associada. O VMM fornece funcionalidade de criação, leitura, atualização e exclusão para gerenciá-los.

Exemplos

Exemplo 1: Criar uma máquina virtual que protege 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 especificado pelo parâmetro VMShieldingDataPath .

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.

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 .

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-JobVariable

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica um nome para o objeto VMShieldingData .

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-OnBehalfOfUser

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:UserRole
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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.

Propriedades do parâmetro

Tipo:Guid
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RawData

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

Propriedades do parâmetro

Tipo:

Byte[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

VMShieldingDataFromBytes
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RunAsynchronously

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMMServer

Especifica um objeto de servidor do VMM.

Propriedades do parâmetro

Tipo:ServerConnection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-VMShieldingDataPath

Especifica o caminho de um arquivo .pdak.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

VMShieldingDataFromPath
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

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:

  • Dados brutos
  • Proprietário KeyProtector
  • KeyProtectorGuardians
  • Nome
  • Descrição