Поделиться через

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

Описание

Командлет New-SCVMShieldingData создает объект VMShieldingData из безопасного blob-объекта подготовки, ФАЙЛА PDK в Virtual Machine Manager (VMM). Этот файл содержит такие сведения, как ключи владения виртуальными машинами, сведения о настройке виртуальной машины, хэши допустимых исходных ключей и другие сведения. Клиенты создают большой двоичный объект подготовки с помощью средства вне диапазона.

Вы можете использовать объект данных экранирования виртуальной машины для таких задач, как шифрование виртуальных доверенных платформенных модулей (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. Команда основывает объект на массиве $Bytes, который указывает параметр RawData.

Параметры

-Description

Указывает описание объекта VMShieldingData.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobVariable

Указывает имя переменной, в которой выполняется задание, отслеживается и хранится.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Задает имя объекта vmShieldingData .

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUser

Указывает имя пользователя. Этот командлет работает от имени пользователя, указанного этим параметром.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-OnBehalfOfUserRole

Указывает роль пользователя. Чтобы получить роль пользователя, используйте командлет Get-SCUserRole . Этот командлет работает от имени роли пользователя, указанной этим параметром.

Тип:UserRole
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RawData

Указывает массив байтов, содержащих необработанные данные PDK.

Тип:Byte[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RunAsynchronously

Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-VMMServer

Указывает объект сервера VMM.

Тип:ServerConnection
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-VMShieldingDataPath

Указывает путь к PDK-файлу.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

None

Выходные данные

VMShieldingData

Этот командлет возвращает объект данных экранирования виртуальной машины, содержащий следующие сведения:

  • RawData
  • KeyProtectorOwner
  • KeyProtectorGuardians
  • Имя
  • Описание