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 pakietów 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 obiekt wirtualnego 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 importuje dysk VHD01 do udziału01).

Parametry

-AllowUnencryptedTransfer

Wskazuje, że transfery plików sieciowych nie wymagają szyfrowania. Jeśli zezwolisz na nieszyfrowane 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.
Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę obiektu programu VMM.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Overwrite

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PackageMapping

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

Typ:PackageMapping[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Password

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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\]"
Typ:String
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SettingsIncludePrivate

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SharePath

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

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TemplatePackage

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

Typ:Package
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMMServer

Określa obiekt serwera programu VMM.

Typ:ServerConnection
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

SCTemplate

To polecenie cmdlet zwraca obiekt SCTemplate.