Dela via

Import-SCTemplate

  • Referens
Modul:
VirtualMachineManager

Importerar en mall eller tjänstmall för virtuella datorer till VMM-biblioteket.

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

Cmdleten Import-SCTemplate importerar en mall eller tjänstmall för virtuella datorer till VMM-biblioteket (Virtual Machine Manager). Om du vill exportera en mall från biblioteket använder du Export-SCTemplate.

Exempel

Exempel 1: Importera ett tidigare exporterat mallpaket

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

Det första kommandot hämtar det exporterade mallpaketobjektet på den angivna sökvägen och lagrar objektet i variabeln $Package.

Det andra kommandot importerar mallpaketobjektet som lagras i $Package, inklusive alla mallinställningar.

Exempel 2: Importera ett exportpaket och ange ett nytt namn och en ny version för den importerade mallen

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

Det här kommandot importerar det angivna mallexportpaketet med alla mallinställningar och anger ett nytt namn och en ny version för den importerade mallen.

Exempel 3: Importera en mall som har vissa/alla resurser i det exporterade paketet vid ändring av mappning

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"

Det första kommandot skapar ett paketmappningsobjekt för paketet som lagras på den angivna sökvägen och lagrar sedan paketmappningsobjektet i variabeln $Mappings.

Det andra kommandot hämtar ett mappningsobjekt efter paket-ID och lagrar objektet i variabeln $Mapping.

Det tredje kommandot hämtar det virtuella hårddiskobjektet med namnet VHD01 och lagrar objektet i variabeln $Resource.

Det fjärde kommandot binder mappningen som lagras i $Mapping till objektet som lagras i $Resource (VHD01).

Det femte kommandot anger paketfilen för mappningen som lagras i $Mapping.

Det senaste kommandot importerar mallen på den angivna sökvägen med de angivna mappningarna (i det här fallet importerar VHD01 till Share01).

Parametrar

-AllowUnencryptedTransfer

Anger att nätverksfilöverföringar inte kräver kryptering. Om du tillåter okrypterade nätverksfilöverföringar kan det förbättra prestandan om varken källvärden eller målvärden kräver kryptering.

Använd den här parametern för att:

  • Tillåt okrypterade filöverföringar till eller från biblioteket.
  • Tillåt okrypterade filöverföringar till, från eller inom en värdgrupp.
Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på ett VMM-objekt.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Overwrite

Anger att en import- eller exportåtgärd skriver över en befintlig fil med samma namn. Eller att en importåtgärd skriver över en befintlig mall för virtuella datorer eller tjänstmallobjekt med samma namn.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PackageMapping

Anger en matris med paketmappningsobjekt.

Typ:PackageMapping[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Password

Anger en säker sträng som innehåller ett lösenord.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger målsökvägen för åtgärden.

Exempelformat:

  • Lokal sökväg: -Path "F:\"
  • UNC-sökväg: -Path "\\Library\Templates"
  • Volym-GUID-sökväg: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • VMware ESX-sökväg: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Citrix XenServer-sökväg: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Release

Anger en sträng som beskriver versionen av en biblioteksresurs. VMM skapar automatiskt ett versionsvärde för varje resurs som importeras till biblioteket. När resursen har importerats kan du anpassa strängen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SettingsIncludePrivate

Anger att inställningar för känsliga mallar ingår i en import- eller exportåtgärd.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SharePath

Anger en sökväg till en giltig biblioteksresurs på en befintlig biblioteksserver som använder en UNC-sökväg (Universal Naming Convention).

Exempelformat: -SharePath "\\LibServer01\LibShare"

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TemplatePackage

Anger ett exporterat mallpaket som innehåller serialiserade inställningar för en tjänst eller mall för virtuella datorer.

Typ:Package
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-VMMServer

Anger ett VMM-serverobjekt.

Typ:ServerConnection
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

Utdata

SCTemplate

Den här cmdleten returnerar ett SCTemplate- objekt.