Share via

New-SCVMShieldingData

  • Riferimento
Modulo:
VirtualMachineManager

Crea un oggetto dati di schermatura della 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 pdk in Virtual Machine Manager (VMM). Questo file include informazioni quali chiavi di proprietà della macchina virtuale, informazioni sulla personalizzazione della macchina virtuale, hash delle 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 le attività, ad esempio la crittografia di moduli di piattaforma attendibili virtuali virtuali (TPMS), la creazione di macchine virtuali schermate e il nonno delle macchine virtuali non schermate.

Il database VMM gestisce gli oggetti dati schermati della macchina virtuale come risorsa di libreria. Vengono definiti in modo appropriato per il ruolo utente associato. VMM fornisce 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 alla variabile $Bytes.

Questo comando crea un oggetto dati di schermatura della macchina virtuale denominato ShieldingData02. Il comando basa l'oggetto nella 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 lo stato di avanzamento del processo viene monitorato e archiviato.

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 che specifica 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 del suggerimento prestazioni e ottimizzazione 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 restituisca 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 macchina virtuale contenente le informazioni seguenti:

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Nome
  • Descrizione