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

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

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

Используйте этот параметр, чтобы:

  • Разрешить незашифрованную передачу файлов в библиотеку или из нее.
  • Разрешить незашифрованную передачу файлов в группу узлов, из нее или внутри нее.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageMapping

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

Type:PackageMapping[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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\]"
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Release

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SettingsIncludePrivate

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SharePath

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TemplatePackage

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

Type:Package
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

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

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

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

SCTemplate

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