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 .