Import-SCTemplate

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

Синтаксис

Path

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

Package

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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Overwrite

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PackageMapping

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

Свойства параметра

Тип:

PackageMapping[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Password

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера: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
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Path
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Release

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SettingsIncludePrivate

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SharePath

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

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TemplatePackage

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

Свойства параметра

Тип:Package
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

Package
Position:Named
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-VMMServer

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

Свойства параметра

Тип:ServerConnection
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

SCTemplate

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