Condividi tramite

New-SCVMShieldingData

  • Riferimento
Modulo:
VirtualMachineManager

Crea un oggetto dati di schermatura di una macchina virtuale da un file con estensione pdk.

Sintassi

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>]

Descrizione

Il cmdlet New-SCVMShieldingData crea un oggetto VMShieldingData da un BLOB di provisioning sicuro, un file con estensione pdk in Virtual Machine Manager (VMM). Questo file include informazioni quali chiavi di proprietà della macchina virtuale, informazioni di personalizzazione della macchina virtuale, hash di chiavi di origine accettabili e altre informazioni. I tenant creano un BLOB di provisioning usando uno strumento fuori banda.

È possibile usare un oggetto dati di schermatura delle macchine virtuali per attività quali la crittografia di moduli TPM (Trusted Platform Modules), la creazione di macchine virtuali schermate e il nonno di macchine virtuali non schermate.

Il database VMM gestisce gli oggetti dati di schermatura delle macchine virtuali come risorsa di libreria. L'ambito è appropriato per il ruolo utente associato. VMM offre funzionalità di creazione, lettura, aggiornamento ed eliminazione per gestirle.

Esempio

Esempio 1: Creare dati di schermatura di una macchina virtuale usando un file con estensione pdk

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

Questo comando crea un oggetto dati di schermatura della macchina virtuale denominato ShieldingData01. Il comando basa l'oggetto nel file SD.pdk specificato dal parametro VMShieldingDataPath.

Esempio 2: Creare dati di schermatura di una macchina virtuale usando dati non elaborati

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

Il primo comando archivia il contenuto di SD.pdf come matrice di byte nella variabile $Bytes.

Questo comando crea un oggetto dati di schermatura della macchina virtuale denominato ShieldingData02. Il comando basa l'oggetto sulla matrice di $Bytes specificata dal parametro RawData .

Parametri

-Description

Specifica una descrizione per l'oggetto VMShieldingData.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-JobVariable

Specifica il nome di una variabile in cui viene rilevato e archiviato lo stato del processo.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Name

Specifica un nome per l'oggetto VMShieldingData .

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OnBehalfOfUser

Specifica un nome utente. Questo cmdlet opera per conto dell'utente specificato da questo parametro.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-OnBehalfOfUserRole

Specifica un ruolo utente. Per ottenere un ruolo utente, usare il cmdlet Get-SCUserRole . Questo cmdlet opera per conto del ruolo utente specificato da questo parametro.

Tipo:UserRole
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PROTipID

Specifica l'ID del suggerimento per le prestazioni e l'ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.

Tipo:Guid
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RawData

Specifica una matrice di byte che contengono dati con estensione pdk non elaborati.

Tipo:Byte[]
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-VMMServer

Specifica un oggetto server VMM.

Tipo:ServerConnection
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-VMShieldingDataPath

Specifica il percorso di un file con estensione pdk.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

VMShieldingData

Questo cmdlet restituisce un oggetto dati di schermatura della macchina virtuale contenente le informazioni seguenti:

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Nome
  • Descrizione