Freigeben über

Import-SCTemplate

  • Referenz
Modul:
VirtualMachineManager

Importiert eine Vorlage für virtuelle Computer oder Dienstvorlagen in die VMM-Bibliothek.

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

Beschreibung

Das Cmdlet "Import-SCTemplate " importiert eine Vorlage für virtuelle Computer oder Dienstvorlagen in die VMM-Bibliothek (Virtual Machine Manager). Um eine Vorlage aus der Bibliothek zu exportieren, verwenden Sie Export-SCTemplate.

Beispiele

Beispiel 1: Importieren eines zuvor exportierten Vorlagenpakets

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

Der erste Befehl ruft das exportierte Vorlagenpaketobjekt im angegebenen Pfad ab und speichert das Objekt in der $Package Variable.

Der zweite Befehl importiert das in $Package gespeicherte Vorlagenpaketobjekt, einschließlich aller Vorlageneinstellungen.

Beispiel 2: Importieren eines Exportpakets und Angeben eines neuen Namens und einer neuen Version für die importierte Vorlage

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

Dieser Befehl importiert das angegebene Vorlagenexportpaket mit allen Einstellungen der Vorlage und gibt einen neuen Namen und eine neue Version für die importierte Vorlage an.

Beispiel 3: Importieren einer Vorlage mit einigen/allen Ressourcen im exportierten Paket beim Ändern der Zuordnung

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"

Der erste Befehl erstellt ein Paketzuordnungsobjekt für das Paket, das im angegebenen Pfad gespeichert ist, und speichert dann das Paketzuordnungsobjekt in der $Mappings Variable.

Der zweite Befehl ruft ein Zuordnungsobjekt nach Paket-ID ab und speichert das Objekt in der $Mapping Variablen.

Der dritte Befehl ruft das virtuelle Festplattenobjekt namens VHD01 ab und speichert das Objekt in der $Resource Variable.

Der vierte Befehl bindet die in $Mapping gespeicherte Zuordnung an das in $Resource (VHD01) gespeicherte Objekt.

Der fünfte Befehl legt die Paketdatei für die in $Mapping gespeicherte Zuordnung fest.

Der letzte Befehl importiert die Vorlage im angegebenen Pfad mit den angegebenen Zuordnungen (in diesem Fall importiert VHD01 in Share01).

Parameter

-AllowUnencryptedTransfer

Gibt an, dass Netzwerkdateiübertragungen keine Verschlüsselung erfordern. Wenn Sie nicht verschlüsselte Netzwerkdateiübertragungen zulassen, kann die Leistung verbessert werden, wenn weder der Quellhost noch der Zielhost Verschlüsselung erfordert.

Verwenden Sie diesen Parameter, um:

  • Erlauben Sie nicht verschlüsselten Dateiübertragungen in die Bibliothek oder aus der Bibliothek.
  • Zulassen von nicht verschlüsselten Dateiübertragungen in eine Hostgruppe oder in einer Hostgruppe.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Gibt den Namen eines VMM-Objekts an.

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

-Overwrite

Gibt an, dass ein Import- oder Exportvorgang eine vorhandene Datei mit demselben Namen überschreibt. Oder dass ein Importvorgang eine vorhandene virtuelle Computervorlage oder ein Dienstvorlagenobjekt mit demselben Namen überschreibt.

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

-PackageMapping

Gibt ein Array von Paketzuordnungsobjekten an.

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

-Password

Gibt eine sichere Zeichenfolge an, die ein Kennwort enthält.

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

-Path

Gibt den Zielpfad für den Vorgang an.

Beispiele für das Format:

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

Gibt eine Zeichenfolge an, die die Veröffentlichung einer Bibliotheksressource beschreibt. VMM erstellt automatisch einen Releasewert für jede Ressource, die in die Bibliothek importiert wurde. Nachdem die Ressource importiert wurde, können Sie die Zeichenfolge anpassen.

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

-SettingsIncludePrivate

Gibt an, dass vertrauliche Vorlageneinstellungen in einem Import- oder Exportvorgang enthalten sind.

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

-SharePath

Gibt einen Pfad zu einer Bibliotheksfreigabe auf einem vorhandenen Bibliothekserver an, für den ein UNC-Pfad (Universal Naming Convention) verwendet wird.

Beispielformat: -SharePath "\\LibServer01\LibShare"

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

-TemplatePackage

Gibt ein exportiertes Vorlagenpaket an, das serialisierte Einstellungen einer Dienst- oder virtuellen Computervorlage enthält.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

Ausgaben

SCTemplate

Dieses Cmdlet gibt ein SCTemplate-Objekt zurück.