Sdílet prostřednictvím

Import-SCTemplate

  • Reference
Modul:
VirtualMachineManager

Importuje šablonu virtuálního počítače nebo šablonu služby do knihovny 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

Rutina Import-SCTemplate importuje šablonu virtuálního počítače nebo šablonu služby do knihovny Nástroje Virtual Machine Manager (VMM). Pokud chcete exportovat šablonu z knihovny, použijte export-SCTemplate.

Příklady

Příklad 1: Import dříve exportovaného balíčku šablony

PS C:\> $Package = Get-SCTemplatePackage -Path "C:\TemplateExports\ServiceTemplate01.new.xml"
PS C:\> Import-SCTemplate -TemplatePackage $Package -SettingsIncludePrivate

První příkaz získá exportovaný objekt balíčku šablony na zadanou cestu a uloží objekt do proměnné $Package.

Druhý příkaz naimportuje objekt balíčku šablony uložený v $Package, včetně všech nastavení šablon.

Příklad 2: Import balíčku exportu a zadání nového názvu a vydání importované šablony

PS C:\> Import-SCTemplate -Path "C:\TemplateExports\ServiceTemplate01.new.xml" -SettingsIncludePrivate -Name "New Service Name" -Release "1.0"

Tento příkaz naimportuje zadaný balíček exportu šablony se všemi nastaveními šablony a určuje nový název a verzi importované šablony.

Příklad 3: Import šablony, která obsahuje některé/všechny prostředky v exportovaného balíčku při změně mapování

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"

První příkaz vytvoří objekt mapování balíčku pro balíček uložený v zadané cestě a pak uloží objekt mapování balíčku do proměnné $Mappings.

Druhý příkaz získá mapovací objekt podle ID balíčku a uloží objekt do proměnné $Mapping.

Třetí příkaz získá objekt virtuálního pevného disku s názvem VHD01 a uloží objekt do proměnné $Resource.

Čtvrtý příkaz vytvoří vazbu mapování uloženého v $Mapping k objektu uloženému v $Resource (VHD01).

Pátý příkaz nastaví soubor balíčku pro mapování uložené v $Mapping.

Poslední příkaz naimportuje šablonu na zadanou cestu se zadanými mapováními (v tomto případě se VHD01 importuje do Share01).

Parametry

-AllowUnencryptedTransfer

Označuje, že přenosy síťových souborů nevyžadují šifrování. Pokud povolíte nešifrované síťové přenosy, může zlepšit výkon, pokud zdrojový hostitel ani cílový hostitel nevyžaduje šifrování.

Tento parametr použijte k:

  • Povolte nešifrované přenosy souborů do knihovny nebo mimo ji.
  • Povolte nešifrované přenosy souborů do skupiny hostitelů, mimo nebo do skupiny hostitelů.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Určuje název objektu VMM.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

Označuje, že operace importu nebo exportu přepíše existující soubor se stejným názvem. Nebo že operace importu přepíše existující šablonu virtuálního počítače nebo objekt šablony služby se stejným názvem.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageMapping

Určuje pole objektů mapování balíčků.

Type:PackageMapping[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

Určuje zabezpečený řetězec, který obsahuje heslo.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Určuje cílovou cestu pro operaci.

Příklady formátů:

  • Místní cesta: -Path "F:\"
  • Cesta UNC: -Path "\\Library\Templates"
  • Cesta GUID svazku: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Cesta K VMware ESX: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Cesta 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

Určuje řetězec, který popisuje vydání prostředku knihovny. Nástroj VMM automaticky vytvoří hodnotu vydané verze pro každý prostředek importovaný do knihovny. Po importu prostředku můžete řetězec přizpůsobit.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SettingsIncludePrivate

Označuje, že citlivá nastavení šablony jsou součástí operace importu nebo exportu.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SharePath

Určuje cestu k platné sdílené složce knihovny na existujícím serveru knihovny, který používá cestu UNC (Universal Naming Convention).

Příklad formátu: -SharePath "\\LibServer01\LibShare"

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TemplatePackage

Určuje exportovaný balíček šablony, který obsahuje serializovaná nastavení šablony služby nebo virtuálního počítače.

Type:Package
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Určuje objekt serveru VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Výstupy

SCTemplate

Tato rutina vrátí objekt SCTemplate .