Sdílet prostřednictvím

New-SCVMShieldingData

  • Reference
Modul:
VirtualMachineManager

Vytvoří datový objekt stínění virtuálního počítače ze souboru .pdk.

Syntaxe

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

Rutina New-SCVMShieldingData vytvoří objekt VMShieldingData z objektu blob zabezpečeného zřizování, souboru .pdk v nástroji Virtual Machine Manager (VMM). Tento soubor obsahuje informace, jako jsou klíče vlastnictví virtuálního počítače, informace o přizpůsobení virtuálního počítače, hodnoty hash přijatelných zdrojových klíčů a další informace. Tenanti vytvářejí objekt blob zřizování pomocí vzdáleného nástroje.

Datový objekt stínění virtuálního počítače můžete použít pro úlohy, jako je šifrování virtuálních čipů TPM (Trusted Platform Modules), vytváření stíněných virtuálních počítačů a dědění nechrněných virtuálních počítačů.

Databáze VMM spravuje datové objekty stínění virtuálních počítačů jako prostředek knihovny. Jsou vymezeny odpovídajícím způsobem pro přidruženou roli uživatele. Nástroj VMM poskytuje funkce pro jejich správu vytváření, čtení, aktualizace a odstraňování.

Příklady

Příklad 1: Vytvoření dat stínění virtuálního počítače pomocí souboru .pdk

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

Tento příkaz vytvoří objekt dat o stínění virtuálního počítače s názvem ShieldingData01. Příkaz zakuje objekt na souboru SD.pdk, který VMShieldingDataPath parametr určuje.

Příklad 2: Vytvoření dat stínění virtuálního počítače pomocí nezpracovaných dat

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

První příkaz ukládá obsah SD.pdf jako pole bajtů do proměnné $Bytes.

Tento příkaz vytvoří objekt dat o stínění virtuálního počítače s názvem ShieldingData02. Příkaz zakází objekt na poli $Bytes, které určuje parametr RawData.

Parametry

-Description

Určuje popis objektu VMShieldingData.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje název proměnné, ve které je průběh úlohy sledován a uložen.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název objektu VMShieldingData.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUser

Určuje uživatelské jméno. Tato rutina funguje jménem uživatele, který tento parametr určuje.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-OnBehalfOfUserRole

Určuje roli uživatele. Pokud chcete získat roli uživatele, použijte rutinu Get-SCUserRole. Tato rutina funguje jménem role uživatele, kterou tento parametr určuje.

Typ:UserRole
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RawData

Určuje pole bajtů, které obsahují nezpracovaná data .pdk.

Typ:Byte[]
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-VMMServer

Určuje objekt serveru VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMShieldingDataPath

Určuje cestu k souboru .pdk.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

VMShieldingData

Tato rutina vrátí datový objekt stínění virtuálního počítače, který obsahuje následující informace:

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Jméno
  • Popis