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 sulla 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 $Bytes specificata dal parametro RawData .

Parametri

-Description

Specifica una descrizione per l'oggetto VMShieldingData .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica un nome per l'oggetto VMShieldingData .

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RawData

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

Type:Byte[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMShieldingDataPath

Specifica il percorso di un file con estensione pdk.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

VMShieldingData

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

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Nome
  • Descrizione