Import-SCTemplate

将虚拟机模板或服务模板导入 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

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

使用此参数可以:

  • 允许将未加密的文件传输到库或移出库。
  • 允许未加密的文件传输到主机组中或内部。
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

此 cmdlet 返回 SCTemplate 对象。