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 中的對應系結至儲存在 VHD01 $Resource (中的物件) 。
第五個命令會針對儲存在 $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 物件。