Udostępnij za pośrednictwem

Import-SCTemplate

  • Odwołanie
Moduł:
VirtualMachineManager

Importuje szablon maszyny wirtualnej lub szablon usługi do biblioteki programu VMM.

Składnia

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

Opis

Polecenie cmdlet Import-SCTemplate importuje szablon maszyny wirtualnej lub szablon usługi do biblioteki programu Virtual Machine Manager (VMM). Aby wyeksportować szablon z biblioteki, użyj polecenia Export-SCTemplate.

Przykłady

Przykład 1. Importowanie wcześniej wyeksportowanego pakietu szablonu

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

Pierwsze polecenie pobiera wyeksportowany obiekt pakietu szablonu w określonej ścieżce i przechowuje obiekt w zmiennej $Package.

Drugie polecenie importuje obiekt pakietu szablonu przechowywany w $Package, w tym wszystkie ustawienia szablonu.

Przykład 2: Importowanie pakietu eksportu i określanie nowej nazwy i wydania zaimportowanego szablonu

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

To polecenie importuje określony pakiet eksportu szablonu ze wszystkimi ustawieniami szablonu i określa nową nazwę i wydanie zaimportowanego szablonu.

Przykład 3: Importowanie szablonu z niektórymi/wszystkimi zasobami w wyeksportowanym pakiecie podczas zmieniania mapowania

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"

Pierwsze polecenie tworzy obiekt mapowania pakietu dla pakietu przechowywanego w określonej ścieżce, a następnie przechowuje obiekt mapowania pakietów w zmiennej $Mappings.

Drugie polecenie pobiera obiekt mapowania według identyfikatora pakietu i przechowuje obiekt w zmiennej $Mapping.

Trzecie polecenie pobiera wirtualny obiekt dysku twardego o nazwie VHD01 i przechowuje obiekt w zmiennej $Resource.

Czwarte polecenie wiąże mapowanie przechowywane w $Mapping z obiektem przechowywanym w $Resource (VHD01).

Piąte polecenie ustawia plik pakietu dla mapowania przechowywanego w $Mapping.

Ostatnie polecenie importuje szablon w określonej ścieżce z określonymi mapowaniami (w tym przypadku VHD01 importuje do udziału01).

Parametry

-AllowUnencryptedTransfer

Wskazuje, że transfery plików sieciowych nie wymagają szyfrowania. Jeśli zezwolisz na niezaszyfrowane transfery plików sieciowych, może zwiększyć wydajność, jeśli host źródłowy ani host docelowy nie wymaga szyfrowania.

Użyj tego parametru, aby:

  • Zezwalaj na niezaszyfrowane transfery plików do biblioteki lub z tej biblioteki.
  • Zezwalaj na niezaszyfrowane transfery plików do grupy hostów lub poza nieszyfrowane.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę obiektu programu VMM.

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

-Overwrite

Wskazuje, że operacja importu lub eksportu zastępuje istniejący plik o tej samej nazwie. Lub, że operacja importowania zastępuje istniejący szablon maszyny wirtualnej lub obiekt szablonu usługi o tej samej nazwie.

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

-PackageMapping

Określa tablicę obiektów mapowania pakietów.

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

-Password

Określa bezpieczny ciąg zawierający hasło.

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

-Path

Określa ścieżkę docelową operacji.

Przykładowe formaty:

  • Ścieżka lokalna: -Path "F:\"
  • Ścieżka UNC: -Path "\\Library\Templates"
  • Ścieżka identyfikatora GUID woluminu: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Ścieżka VMware ESX: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Ścieżka 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

Określa ciąg opisujący wydanie zasobu biblioteki. Program VMM automatycznie tworzy wartość wydania dla każdego zasobu zaimportowanego do biblioteki. Po zaimportowaniu zasobu można dostosować ciąg.

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

-SettingsIncludePrivate

Wskazuje, że poufne ustawienia szablonu są uwzględniane w operacji importowania lub eksportowania.

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

-SharePath

Określa ścieżkę do prawidłowego udziału biblioteki na istniejącym serwerze biblioteki, który używa ścieżki UNC (Universal Naming Convention).

Przykładowy format: -SharePath "\\LibServer01\LibShare"

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

-TemplatePackage

Określa wyeksportowany pakiet szablonu zawierający serializowane ustawienia usługi lub szablonu maszyny wirtualnej.

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

-VMMServer

Określa obiekt serwera programu VMM.

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

Dane wyjściowe

SCTemplate

To polecenie cmdlet zwraca obiekt SCTemplate .