Freigeben über

Import-SCTemplate

  • Referenz
Modul:
VirtualMachineManager

Importiert eine Vorlage oder Dienstvorlage eines virtuellen Computers 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). Verwenden Sie "Export-SCTemplate", um eine Vorlage aus der Bibliothek zu exportieren.

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 Variablen.

Der zweite Befehl importiert das vorlagenpaketobjekt, das in $Package gespeichert ist, einschließlich aller Vorlageneinstellungen.

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

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

Mit diesem Befehl wird das angegebene Vorlagenexportpaket mit allen Einstellungen der Vorlage importiert und ein neuer Name und eine Freigabe für die importierte Vorlage angegeben.

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 Variablen.

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 mit dem Namen VHD01 ab und speichert das Objekt in der $Resource Variablen.

Der vierte Befehl bindet die in $Mapping gespeicherte Zuordnung an das objekt, das in $Resource (VHD01) gespeichert ist.

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 unverschlüsselte Netzwerkdateiübertragungen zulassen, kann sie die Leistung verbessern, wenn weder der Quellhost noch der Zielhost Verschlüsselung erfordert.

Verwenden Sie diesen Parameter, um:

  • Lassen Sie unverschlüsselte Dateiübertragungen in oder aus der Bibliothek zu.
  • Zulassen unverschlüsselter Dateiübertragungen in, außerhalb oder innerhalb einer Hostgruppe.
Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines VMM-Objekts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Overwrite

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PackageMapping

Gibt ein Array von Paketzuordnungsobjekten an.

Typ:PackageMapping[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Password

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Path

Gibt den Zielpfad für den Vorgang an.

Beispielformate:

  • 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\]"
Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Release

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SettingsIncludePrivate

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SharePath

Gibt einen Pfad zu einer gültigen Bibliotheksfreigabe auf einem vorhandenen Bibliotheksserver an, der einen UNC-Pfad (Universal Naming Convention) verwendet.

Beispielformat: -SharePath "\\LibServer01\LibShare"

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TemplatePackage

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

Typ:Package
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

SCTemplate

Dieses Cmdlet gibt ein SCTemplate--Objekt zurück.