Condividi tramite

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 VMM (Virtual Machine Manager). 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/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 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 mapping per 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 del pacchetto per il mapping archiviato in $Mapping.

L'ultimo comando importa il modello nel percorso specificato con i mapping specificati (in questo caso, le importazioni VHD01 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 l'host di origine o l'host di destinazione richiedono la crittografia.

Usare questo parametro per:

  • Consenti trasferimenti di file non crittografati all'interno o all'esterno della libreria.
  • Consenti trasferimenti di file non crittografati in, fuori 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 esistente o un oggetto modello di servizio 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 la versione di una risorsa di libreria. VMM crea automaticamente un valore di versione per ogni risorsa importata nella libreria. Dopo l'importazione della 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 contenente 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 .