Freigeben über

Export-SCTemplate

  • Referenz
Modul:
VirtualMachineManager

Exportiert eine Vorlage aus der VMM-Bibliothek in den angegebenen Pfad.

Syntax

Export-SCTemplate
      [-VMTemplate] <Template>
      -Path <String>
      [-SettingsIncludePrivate]
      [-Overwrite]
      [-Password <String>]
      [-IncludeLibraryResources <ItemBase[]>]
      [-AllowUnencryptedTransfer]
      [-IncludeAllLibraryResources]
      [-VMMServer <ServerConnection>]
      [<CommonParameters>]
Export-SCTemplate
      [-ServiceTemplate] <ServiceTemplate>
      -Path <String>
      [-SettingsIncludePrivate]
      [-Overwrite]
      [-Password <String>]
      [-IncludeLibraryResources <ItemBase[]>]
      [-AllowUnencryptedTransfer]
      [-IncludeAllLibraryResources]
      [-VMMServer <ServerConnection>]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Export-SCTemplate exportiert eine Vorlage aus der VMM-Bibliothek (Virtual Machine Manager) in den angegebenen Pfad. Sie können auch die Bibliotheksobjekte exportieren, von denen die Vorlage abhängig ist.

Beispiele

Beispiel 1: Exportieren einer Dienstvorlage mit allen zugehörigen Einstellungen

PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> Export-SCTemplate -ServiceTemplate $ServiceTemplate -Path "C:\TemplateExports" -SettingsIncludePrivate -Overwrite

Der erste Befehl ruft das Dienstvorlagenobjekt namens ServiceTemplate01 ab und speichert das Objekt in der $ServiceTemplate Variablen.

Der zweite Befehl exportiert die in $ServiceTemplate gespeicherte Dienstvorlage, einschließlich aller Einstellungen, und überschreibt vorhandene Vorlagenexportpakete mit demselben Namen.

Beispiel 2: Exportieren mehrerer Dienstvorlagen mit allen einstellungen

PS C:\> Get-SCServiceTemplate | Export-SCTemplate -Path "C:\TemplateExports" -SettingsIncludePrivate -Overwrite

Dieser Befehl verwendet das Cmdlet Get-SCServiceTemplate, um alle Dienstvorlagenobjekte abzurufen. Anschließend wird der Pipelineoperator verwendet, um die Objekte an das Cmdlet Export-SCTemplate zu senden, das die Vorlagen exportiert und vorhandene Dateien überschreibt.

Beispiel 3: Exportieren einer Dienstvorlage einschließlich der abhängigen Bibliotheksressourcen

PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> Export-SCTemplate -ServiceTemplate $ServiceTemplate -Path "C:\TemplateExports" -IncludeAllLibraryResources

Der erste Befehl ruft das Dienstvorlagenobjekt namens ServiceTemplate01 ab und speichert das Objekt in der $ServiceTemplate Variablen.

Der zweite Befehl exportiert ServiceTemplate01 und alle abhängigen Ressourcen aus der VMM-Bibliothek in C:\TempalteExports.

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

-IncludeAllLibraryResources

Gibt an, dass alle Abhängigkeiten für eine Vorlage aus der VMM-Bibliothek mit der Vorlage exportiert werden.

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

-IncludeLibraryResources

Gibt abhängige Bibliotheksressourcen an, die mit einer Vorlage exportiert werden sollen.

Typ:ItemBase[]
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

-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

-ServiceTemplate

Gibt ein Dienstvorlagenobjekt an.

Typ:ServiceTemplate
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

-VMTemplate

Gibt ein VMM-Vorlagenobjekt an, das zum Erstellen virtueller Computer verwendet wird.

Typ:Template
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Ausgaben

SCTemplate

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