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.

Syntaxe

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). K exportu šablony 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 zadané cestě a uloží objekt do $Package proměnné.

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

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 importuje 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 s některými/všemi prostředky v exportovaném 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 $Mappings proměnné.

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

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ě 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 souborů, může zvýšit výkon, pokud ani zdrojový hostitel ani cílový hostitel nevyžaduje šifrování.

Tento parametr použijte k:

  • Povolte nešifrované přenosy souborů do knihovny nebo z této knihovny nebo z této knihovny.
  • Povolte nešifrované přenosy souborů do skupiny hostitelů, mimo nebo v rámci skupiny hostitelů.
Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Name

Určuje název objektu VMM.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PackageMapping

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

Typ:PackageMapping[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Password

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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\]"
Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Release

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

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SettingsIncludePrivate

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

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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"

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TemplatePackage

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

Typ:Package
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-VMMServer

Určuje objekt serveru VMM.

Typ:ServerConnection
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Výstupy

SCTemplate

Tato rutina vrátí objekt SCTemplate.