Share via

Import-SCTemplate

  • Riferimento
Modulo:
VirtualMachineManager

Importa un modello di macchina virtuale o un modello di servizio nella libreria VMM.

Sintassi

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

Descrizione

Il cmdlet Import-SCTemplate importa un modello di macchina virtuale o un modello di servizio nella libreria Virtual Machine Manager (VMM). Per esportare un modello dalla libreria, usare Export-SCTemplate.

Esempio

Esempio 1: Importare un pacchetto modello esportato in precedenza

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

Il primo comando ottiene l'oggetto pacchetto modello esportato nel percorso specificato e archivia l'oggetto nella variabile $Package.

Il secondo comando importa l'oggetto pacchetto modello archiviato in $Package, incluse tutte le impostazioni del modello.

Esempio 2: Importare un pacchetto di esportazione e specificare un nuovo nome e una nuova versione per il modello importato

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

Questo comando importa il pacchetto di esportazione del modello specificato con tutte le impostazioni del modello e specifica un nuovo nome e una nuova versione per il modello importato.

Esempio 3: Importare un modello con alcune o tutte le risorse nel pacchetto esportato durante la modifica del mapping

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"

Il primo comando crea un oggetto di mapping del pacchetto per il pacchetto archiviato nel percorso specificato e quindi archivia l'oggetto mapping del pacchetto nella variabile $Mappings.

Il secondo comando ottiene un oggetto di mapping in base all'ID pacchetto e archivia l'oggetto nella variabile $Mapping.

Il terzo comando ottiene l'oggetto disco rigido virtuale denominato VHD01 e archivia l'oggetto nella variabile $Resource.

Il quarto comando associa il mapping archiviato in $Mapping all'oggetto archiviato in $Resource (VHD01).

Il quinto comando imposta il file di pacchetto per il mapping archiviato in $Mapping.

L'ultimo comando importa il modello nel percorso specificato con i mapping specificati (in questo caso, VHD01 importa in Share01).

Parametri

-AllowUnencryptedTransfer

Indica che i trasferimenti di file di rete non richiedono la crittografia. Se si consentono trasferimenti di file di rete non crittografati, è possibile migliorare le prestazioni se né l'host di origine né l'host di destinazione richiedono la crittografia.

Usare questo parametro per:

  • Consente trasferimenti di file non crittografati all'interno o all'esterno della libreria.
  • Consenti trasferimenti di file non crittografati in, all'esterno o all'interno di un gruppo host.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifica il nome di un oggetto di VMM.

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

-Overwrite

Indica che un'operazione di importazione o esportazione sovrascrive un file esistente con lo stesso nome. In alternativa, un'operazione di importazione sovrascrive un modello di macchina virtuale o un oggetto modello di servizio esistente con lo stesso nome.

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

-PackageMapping

Specifica una matrice di oggetti di mapping dei pacchetti.

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

-Password

Specifica una stringa sicura che contiene una password.

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

-Path

Specifica il percorso di destinazione per l'operazione.

Formati di esempio:

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

Specifica una stringa che descrive il rilascio di una risorsa di libreria. VMM crea automaticamente un valore di versione per ogni risorsa importata nella libreria. Dopo aver importato la risorsa, è possibile personalizzare la stringa.

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

-SettingsIncludePrivate

Indica che le impostazioni del modello sensibili sono incluse in un'operazione di importazione o esportazione.

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

-SharePath

Specifica il percorso di una condivisione di libreria valida su un server di libreria esistente che utilizza un percorso UNC (Universal Naming Convention).

Formato di esempio: -SharePath "\\LibServer01\LibShare"

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

-TemplatePackage

Specifica un pacchetto modello esportato che contiene le impostazioni serializzate di un modello di servizio o macchina virtuale.

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

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

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

Output

SCTemplate

Questo cmdlet restituisce un oggetto SCTemplate .