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

Import-SCTemplate

  • Ссылка
Модуль:
VirtualMachineManager

Импортирует шаблон виртуальной машины или шаблон службы в библиотеку VMM.

Синтаксис

Import-SCTemplate
      -Path <String>
      [-Name <String>]
      [-Release <String>]
      [-Overwrite]
      [-SettingsIncludePrivate]
      [-PackageMapping <PackageMapping[]>]
      [-AllowUnencryptedTransfer]
      [-SharePath <String>]
      [-Password <String>]
      [-VMMServer <ServerConnection>]
      [<CommonParameters>]
Import-SCTemplate
      -TemplatePackage <Package>
      [-Name <String>]
      [-Release <String>]
      [-Overwrite]
      [-SettingsIncludePrivate]
      [-PackageMapping <PackageMapping[]>]
      [-AllowUnencryptedTransfer]
      [-SharePath <String>]
      [-Password <String>]
      [-VMMServer <ServerConnection>]
      [<CommonParameters>]

Описание

Командлет import-SCTemplate импортирует шаблон виртуальной машины или шаблон службы в библиотеку Virtual Machine Manager (VMM). Чтобы экспортировать шаблон из библиотеки, используйте Export-SCTemplate.

Примеры

Пример 1. Импорт ранее экспортированного пакета шаблона

PS C:\> $Package = Get-SCTemplatePackage -Path "C:\TemplateExports\ServiceTemplate01.new.xml"
PS C:\> Import-SCTemplate -TemplatePackage $Package -SettingsIncludePrivate

Первая команда получает экспортируемый объект пакета шаблона по указанному пути и сохраняет объект в переменной $Package.

Вторая команда импортирует объект пакета шаблона, хранящийся в $Package, включая все параметры шаблона.

Пример 2. Импорт пакета экспорта и указание нового имени и выпуска для импортированного шаблона

PS C:\> Import-SCTemplate -Path "C:\TemplateExports\ServiceTemplate01.new.xml" -SettingsIncludePrivate -Name "New Service Name" -Release "1.0"

Эта команда импортирует указанный пакет экспорта шаблона со всеми параметрами шаблона и задает новое имя и выпуск импортированного шаблона.

Пример 3. Импорт шаблона с некоторыми или всеми ресурсами в экспортируемом пакете при изменении сопоставления

PS C:\> $Mappings = New-SCPackageMapping -Path "C:\TemplateExports\VMTemplate01.xml" -PreferPackageResources
PS C:\> $Mapping = $Mappings | where {$_.PackageID -eq "VHD01.vhd"}
PS C:\> $Resource = Get-SCVirtualHardDisk -Name "VHD01.vhd"
PS C:\> Set-SCPackageMapping -PackageMapping $Mapping -TargetObject $Resource
PS C:\> Set-SCPackageMapping -PackageMapping $Mapping -PackageFile "C:\TemplateExports\Resources\VHD01.vhd"
PS C:\> Import-SCTemplate -Path C:\TemplateExports\VMTemplate01.xml -PackageMapping $Mapping -SharePath "\\LibServer01\Share01"

Первая команда создает объект сопоставления пакетов для пакета, хранящегося по указанному пути, а затем сохраняет объект сопоставления пакетов в переменной $Mappings.

Вторая команда получает объект сопоставления по идентификатору пакета и сохраняет объект в переменной $Mapping.

Третья команда получает объект виртуального жесткого диска с именем VHD01 и сохраняет объект в переменной $Resource.

Четвертая команда привязывает сопоставление, хранящееся в $Mapping, к объекту, хранящейся в $Resource (VHD01).

Пятая команда задает файл пакета для сопоставления, хранящегося в $Mapping.

Последняя команда импортирует шаблон по указанному пути с указанными сопоставлениями (в данном случае VHD01 импортируется в Share01).

Параметры

-AllowUnencryptedTransfer

Указывает, что передача сетевых файлов не требует шифрования. Если вы разрешаете передачу незашифрованных сетевых файлов, это может повысить производительность, если ни исходный узел, ни целевой узел не требуют шифрования.

Используйте этот параметр для:

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

-Name

Указывает имя объекта VMM.

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

-Overwrite

Указывает, что операция импорта или экспорта перезаписывает существующий файл с тем же именем. Кроме того, операция импорта перезаписывает существующий шаблон виртуальной машины или объект шаблона службы с тем же именем.

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

-PackageMapping

Задает массив объектов сопоставления пакетов.

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

-Password

Указывает безопасную строку, содержащую пароль.

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

-Path

Указывает путь назначения для операции.

Примеры форматов:

  • Локальный путь: -Path "F:\"
  • UNC-путь: -Path "\\Library\Templates"
  • Путь GUID тома: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Путь VMware ESX: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Путь Citrix XenServer: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Release

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

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

-SettingsIncludePrivate

Указывает, что конфиденциальные параметры шаблона включены в операцию импорта или экспорта.

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

-SharePath

Указывает путь к допустимой общей папке библиотеки на существующем сервере библиотеки, использующем UNC-путь.

Пример формата: -SharePath "\\LibServer01\LibShare"

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

-TemplatePackage

Указывает экспортируемый пакет шаблона, содержащий сериализованные параметры службы или шаблона виртуальной машины.

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

-VMMServer

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

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

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

SCTemplate

Этот командлет возвращает объект SCTemplate.