通过

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 cmdlet 将虚拟机模板或服务模板导入 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变量中。

第二个命令按包 ID 获取映射对象，并将对象存储在$Mapping变量中。

第三个命令获取名为 VHD01 的虚拟硬盘对象，并将该对象存储在$Resource变量中。

第四个命令将存储在$Mapping中的映射绑定到存储在 $Resource （VHD01） 中的对象。

第五个命令设置存储在$Mapping中的映射的包文件。

最后一个命令使用指定的映射（在本例中，VHD01 导入到 Share01）的指定路径处导入模板。

参数

-AllowUnencryptedTransfer

指示网络文件传输不需要加密。 如果允许未加密的网络文件传输，则如果源主机和目标主机都不需要加密，则它可以提高性能。

使用此参数可以：

  • 允许将未加密的文件传输到库或传出库。
  • 允许未加密的文件传输到主机组或主机组中。
类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定 VMM 对象的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Overwrite

指示导入或导出操作覆盖具有相同名称的现有文件。 或者，导入操作会覆盖具有相同名称的现有虚拟机模板或服务模板对象。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PackageMapping

指定包映射对象的数组。

类型:PackageMapping[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Password

指定包含密码的安全字符串。

类型:String
Position:Named
默认值: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
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Release

指定描述库资源的发布的字符串。 VMM 会自动为导入库的每个资源创建发布值。 导入资源后，可以自定义字符串。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SettingsIncludePrivate

指示导入或导出操作中包括敏感模板设置。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SharePath

指定使用通用命名约定 （UNC） 路径的现有库服务器上的有效库共享的路径。

示例格式：-SharePath "\\LibServer01\LibShare"

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-TemplatePackage

指定一个导出的模板包，其中包含服务或虚拟机模板的序列化设置。

类型:Package
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-VMMServer

指定 VMM 服务器对象。

类型:ServerConnection
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输出

SCTemplate

此 cmdlet 返回 SCTemplate 对象。