New-SCVMShieldingData
從 .pdk 檔案建立虛擬機器防護資料物件。
Syntax
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 中的安全布建 Blob、.pdk 檔案建立VMShieldingData物件， (VMM) 。 此檔案包含虛擬機器擁有權金鑰、虛擬機器自訂資訊、可接受的來源金鑰雜湊和其他資訊等資訊。 租使用者會使用頻外工具建立布建 Blob。
您可以使用虛擬機器防護資料物件來執行加密虛擬信賴平臺模組 (TPM) 、建立受防護的虛擬機器，以及父代未受防護虛擬機器等工作。
VMM 資料庫會將虛擬機器防護資料物件當做程式庫資源來管理。 它們的範圍會適當地設定為相關聯的使用者角色。 VMM 提供建立、讀取、更新和刪除功能來管理它們。
範例
範例 1：使用 .pdk 檔案建立虛擬機器防護資料
PS C:\> New-SCVMShieldingData -Name "ShieldingData01" -Description "Shielding data" -VMShieldingDataPath "C:\virtual\SD.pdk"此命令會建立名為 ShieldingData01 的虛擬機器防護資料物件。 命令會以 VMShieldingDataPath 參數所指定的 SD.pdk 檔案為基礎。
範例 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 物件的描述。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
指定追蹤和儲存作業進度的變數名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定 VMShieldingData 物件的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
指定使用者名稱。 這個 Cmdlet 會代表此參數所指定的使用者運作。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定使用者角色。 若要取得使用者角色，請使用 Get-SCUserRole Cmdlet。 這個 Cmdlet 會代表此參數所指定的使用者角色運作。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
指定觸發此動作 (PRO 提示) 效能和資源優化提示的識別碼。 此參數可讓您稽核 PRO 秘訣。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RawData
指定包含原始 .pdk 資料的位元組陣列。
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
表示作業會以非同步方式執行，讓控制項立即返回命令殼層。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
指定 VMM 伺服器物件。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-VMShieldingDataPath
指定 .pdk 檔案的路徑。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
None
輸出
VMShieldingData
此 Cmdlet 會傳回包含下列資訊的虛擬機器防護資料物件：
- RawData
- KeyProtectorOwner
- KeyProtectorGuardian
- 名稱
- 描述