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 sista 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 prestanda 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.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Anger namnet på ett VMM-objekt.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-PackageMapping

Anger en matris med paketmappningsobjekt.

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

-Password

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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\]"
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-SettingsIncludePrivate

Anger att känsliga mallinställningar ingår i en import- eller exportåtgärd.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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"

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

-TemplatePackage

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

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

-VMMServer

Anger ett VMM-serverobjekt.

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

Utdata

SCTemplate

Den här cmdleten returnerar ett SCTemplate-objekt .