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 物件。