共用方式為


Import-SCTemplate

將虛擬機器範本或服務範本匯入 VMM 程式庫。

Syntax

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>]

Description

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變數中。

第二個命令會依封裝識別碼取得對應物件,並將物件儲存在$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 物件。