Udostępnij za pośrednictwem

New-SCVMShieldingData

  • Odwołanie
Moduł:
VirtualMachineManager

Tworzy obiekt danych osłony maszyny wirtualnej na podstawie pliku .pdk.

Składnia

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

Opis

Polecenie cmdlet New-SCVMShieldingData tworzy obiekt VMShieldingData na podstawie bezpiecznego obiektu blob aprowizacji, pliku .pdk w programie Virtual Machine Manager (VMM). Ten plik zawiera informacje, takie jak klucze własności maszyny wirtualnej, informacje o dostosowywaniu maszyny wirtualnej, skróty dopuszczalnych kluczy źródłowych i inne informacje. Dzierżawcy tworzą obiekt blob aprowizacji przy użyciu narzędzia poza pasmem.

Można użyć obiektu danych osłony maszyny wirtualnej do zadań, takich jak szyfrowanie wirtualnych modułów zaufanej platformy (TPM), tworzenie chronionych maszyn wirtualnych i dziadek niechronionych maszyn wirtualnych.

Baza danych programu VMM zarządza obiektami danych osłony maszyn wirtualnych jako zasób biblioteki. Są one odpowiednio ograniczone do skojarzonej roli użytkownika. Program VMM zapewnia funkcje tworzenia, odczytu, aktualizowania i usuwania, aby nimi zarządzać.

Przykłady

Przykład 1. Tworzenie danych osłony maszyny wirtualnej przy użyciu pliku .pdk

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

To polecenie tworzy obiekt danych osłony maszyny wirtualnej o nazwie ShieldingData01. Polecenie opiera obiekt w pliku SD.pdk, który określa parametr VMShieldingDataPath .

Przykład 2. Tworzenie danych osłony maszyny wirtualnej przy użyciu danych pierwotnych

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

Pierwsze polecenie przechowuje zawartość SD.pdf jako tablicę bajtów do zmiennej $Bytes.

To polecenie tworzy obiekt danych osłony maszyny wirtualnej o nazwie ShieldingData02. Polecenie opiera obiekt na tablicy $Bytes, którą określa parametr RawData .

Parametry

-Description

Określa opis obiektu VMShieldingData .

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

-JobVariable

Określa nazwę zmiennej, w której postęp zadania jest śledzony i przechowywany.

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

-Name

Określa nazwę obiektu VMShieldingData .

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

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.

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

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole . To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.

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

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

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

-RawData

Określa tablicę bajtów, które zawierają nieprzetworzone dane .pdk.

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

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

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

-VMMServer

Określa obiekt serwera programu VMM.

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

-VMShieldingDataPath

Określa ścieżkę pliku .pdk.

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

Dane wejściowe

None

Dane wyjściowe

VMShieldingData

To polecenie cmdlet zwraca obiekt danych osłony maszyny wirtualnej zawierający następujące informacje:

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Nazwa
  • Opis