共用方式為

New-SCVMShieldingData

  • 參考
模組:
VirtualMachineManager

從 .pdk 檔案建立保護數據對象的虛擬機。

語法

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

New-SCVMShieldingData Cmdlet 會從 Virtual Machine Manager （VMM） 中的安全佈建 Blob 物件建立 VMShieldingData 物件。 此檔案包含虛擬機擁有權密鑰、虛擬機自定義資訊、可接受的來源密鑰哈希和其他資訊等資訊。 租使用者會使用頻外工具建立布建 Blob。

您可以將虛擬機防護數據對象用於加密虛擬信任平臺模組（TPM）、建立受防護的虛擬機，以及祖父非受防護虛擬機等工作。

VMM 資料庫會管理虛擬機，以連結庫資源的形式保護數據物件。 它們的範圍會適當地設定為相關聯的使用者角色。 VMM 提供建立、讀取、更新和刪除功能來管理它們。

範例

範例 1：使用 .pdk 檔案建立虛擬機防護數據

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

此命令會建立名為 ShieldingData01 的虛擬機防護數據物件。 命令會將 物件基底在 SD.pdk 檔案上，VMShieldingDataPath 參數所指定。

範例 2：使用原始數據建立虛擬機防護數據

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

第一個命令會將 SD.pdf 的內容儲存為$Bytes變數的位元組陣列。

此命令會建立名為 ShieldingData02 的虛擬機防護數據物件。 命令會將 物件基底放在 RawData 參數所指定的$Bytes陣列上。

參數

-Description

指定 VMShieldingData 物件的描述。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-JobVariable

指定追蹤和儲存作業進度的變數名稱。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定 VMShieldingData 物件的名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-OnBehalfOfUser

指定用戶名稱。 這個 Cmdlet 代表此參數指定的用戶運作。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-OnBehalfOfUserRole

指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 代表此參數指定的使用者角色運作。

類型:UserRole
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PROTipID

指定觸發此動作之效能和資源優化提示 （PRO 提示） 的識別碼。 此參數可讓您稽核 PRO 秘訣。

類型:Guid
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RawData

指定包含原始 .pdk 數據的位元組陣列。

類型:Byte[]
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-RunAsynchronously

表示作業會以異步方式執行，讓控件立即返回命令殼層。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VMMServer

指定 VMM 伺服器物件。

類型:ServerConnection
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-VMShieldingDataPath

指定 .pdk 檔案的路徑。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

輸入

None

輸出

VMShieldingData

此 Cmdlet 會傳回包含下列資訊的虛擬機防護資料物件：

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • 名字
  • 描述