Udostępnij za pośrednictwem

New-SCVMShieldingData

  • Odwołanie
Moduł:
VirtualMachineManager

Tworzy obiekt danych osłony maszyny wirtualnej z 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 z 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 trusted platform (TPM), tworzenie chronionych maszyn wirtualnych i dziadek niechronionych maszyn wirtualnych.

Baza danych programu VMM zarządza obiektami danych osłony maszyn wirtualnych jako zasobem biblioteki. Są one odpowiednio ograniczone do skojarzonej roli użytkownika. Program VMM udostępnia funkcje tworzenia, odczytu, aktualizowania i usuwania w celu zarządzania nimi.

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.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-JobVariable

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę obiektu VMShieldingData.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-OnBehalfOfUser

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:UserRole
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:Guid
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RawData

Określa tablicę bajtów zawierających nieprzetworzone dane .pdk.

Typ:Byte[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-VMMServer

Określa obiekt serwera programu VMM.

Typ:ServerConnection
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMShieldingDataPath

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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