共用方式為


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

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

表示網路檔案傳輸不需要加密。 如果您允許未加密的網路檔案傳輸,如果來源主機和目的地主機都不需要加密,它可以改善效能。

使用此參數來:

  • 允許未加密的檔案傳輸進入或移出連結庫。
  • 允許未加密的檔案傳輸進入、移出或移出主機群組內。
類型: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 物件。