Delen via

Import-SCTemplate

  • Referentie
Module:
VirtualMachineManager

Hiermee importeert u een sjabloon of servicesjabloon voor virtuele machines in de VMM-bibliotheek.

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

Met de cmdlet Import-SCTemplate importeert u een virtuele-machinesjabloon of servicesjabloon in de VMM-bibliotheek (Virtual Machine Manager). Als u een sjabloon uit de bibliotheek wilt exporteren, gebruikt u Export-SCTemplate.

Voorbeelden

Voorbeeld 1: Een eerder geëxporteerd sjabloonpakket importeren

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

Met de eerste opdracht wordt het geëxporteerde sjabloonpakketobject opgehaald op het opgegeven pad en wordt het object opgeslagen in de $Package variabele.

Met de tweede opdracht importeert u het sjabloonpakketobject dat is opgeslagen in $Package, inclusief alle sjablooninstellingen.

Voorbeeld 2: Een exportpakket importeren en een nieuwe naam en release opgeven voor de geïmporteerde sjabloon

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

Met deze opdracht importeert u het opgegeven sjabloonexportpakket met alle instellingen van de sjabloon en geeft u een nieuwe naam en release voor de geïmporteerde sjabloon op.

Voorbeeld 3: Een sjabloon importeren met een aantal/alle resources in het geëxporteerde pakket tijdens het wijzigen van de toewijzing

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"

Met de eerste opdracht maakt u een pakkettoewijzingsobject voor het pakket dat is opgeslagen op het opgegeven pad en slaat u vervolgens het pakkettoewijzingsobject op in de $Mappings variabele.

Met de tweede opdracht wordt een toewijzingsobject op basis van pakket-id opgehaald en wordt het object opgeslagen in de $Mapping variabele.

Met de derde opdracht wordt het virtuele hardeschijfobject met de naam VHD01 opgehaald en wordt het object opgeslagen in de $Resource variabele.

Met de vierde opdracht wordt de toewijzing die in $Mapping is opgeslagen, gekoppeld aan het object dat is opgeslagen in $Resource (VHD01).

Met de vijfde opdracht wordt het pakketbestand ingesteld voor de toewijzing die is opgeslagen in $Mapping.

Met de laatste opdracht importeert u de sjabloon op het opgegeven pad met de opgegeven toewijzingen (in dit geval importeert VHD01 naar Share01).

Parameters

-AllowUnencryptedTransfer

Geeft aan dat netwerkbestandsoverdracht geen versleuteling vereist. Als u niet-versleutelde netwerkbestandsoverdrachten toestaat, kan dit de prestaties verbeteren als de bronhost of de doelhost versleuteling vereist.

Gebruik deze parameter om:

  • Niet-versleutelde bestandsoverdrachten naar of uit de bibliotheek toestaan.
  • Niet-versleutelde bestandsoverdrachten naar, uit of binnen een hostgroep toestaan.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Hiermee geeft u de naam van een VMM-object.

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

-Overwrite

Geeft aan dat een import- of exportbewerking een bestaand bestand met dezelfde naam overschrijft. Of dat een importbewerking een bestaand sjabloon of servicesjabloonobject met dezelfde naam overschrijft.

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

-PackageMapping

Hiermee geeft u een matrix van pakkettoewijzingsobjecten.

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

-Password

Hiermee geeft u een beveiligde tekenreeks die een wachtwoord bevat.

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

-Path

Hiermee geeft u het doelpad voor de bewerking.

Voorbeelden van indelingen:

  • Lokaal pad: -Path "F:\"
  • UNC-pad: -Path "\\Library\Templates"
  • Volume-GUID-pad: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • VMware ESX-pad: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Citrix XenServer-pad: -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

Hiermee geeft u een tekenreeks op die de release van een bibliotheekresource beschrijft. VMM maakt automatisch een releasewaarde voor elke resource die in de bibliotheek is geïmporteerd. Nadat de resource is geïmporteerd, kunt u de tekenreeks aanpassen.

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

-SettingsIncludePrivate

Geeft aan dat instellingen voor gevoelige sjablonen zijn opgenomen in een import- of exportbewerking.

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

-SharePath

Hiermee geeft u een pad naar een geldige bibliotheekshare op een bestaande bibliotheekserver die gebruikmaakt van een UNC-pad (Universal Naming Convention).

Voorbeeldindeling: -SharePath "\\LibServer01\LibShare"

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

-TemplatePackage

Hiermee geeft u een geëxporteerd sjabloonpakket op dat geserialiseerde instellingen van een service- of virtuele-machinesjabloon bevat.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

SCTemplate

Met deze cmdlet wordt een SCTemplate-object geretourneerd.