New-SCVMShieldingData
.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>] 説明
New-SCVMShieldingData コマンドレットは、Virtual Machine Manager (VMM) で、セキュリティで保護されたプロビジョニング BLOB (.pdk ファイル) から VMShieldingData オブジェクトを作成します。 このファイルには、仮想マシンの所有権キー、仮想マシンのカスタマイズ情報、許容されるソース キーのハッシュなどの情報が含まれます。 テナントは、帯域外ツールを使用してプロビジョニング 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 オブジェクトの説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡して格納する変数の名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
VMShieldingData オブジェクトの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RawData
生の .pdk データを含むバイトの配列を指定します。
| 型: | Byte[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-VMShieldingDataPath
.pdk ファイルのパスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
None
出力
VMShieldingData
このコマンドレットは、次の情報を含む仮想マシンシールド データ オブジェクトを返します。
- RawData
- KeyProtectorOwner
- KeyProtectorGuardians
- 名前
- 形容