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

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

使用此参数可以：

• 允许将未加密的文件传输到库或移出库。
• 允许未加密的文件传输到主机组中或内部。

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 对象。

相关链接

• Export-SCTemplate
• Get-SCTemplatePackage
• Get-SCVirtualHardDisk
• New-SCPackageMapping