Partager via

Import-SCTemplate

  • Référence
Module:
VirtualMachineManager

Importe un modèle de machine virtuelle ou un modèle de service dans la bibliothèque VMM.

Syntaxe

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

Description

L’applet de commande Import-SCTemplate importe un modèle de machine virtuelle ou un modèle de service dans la bibliothèque VMM (Virtual Machine Manager). Pour exporter un modèle à partir de la bibliothèque, utilisez Export-SCTemplate.

Exemples

Exemple 1 : Importer un package de modèle précédemment exporté

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

La première commande obtient l’objet de package de modèle exporté au chemin d’accès spécifié et stocke l’objet dans la variable $Package.

La deuxième commande importe l’objet de package de modèle stocké dans $Package, y compris tous les paramètres de modèle.

Exemple 2 : Importer un package d’exportation et spécifier un nouveau nom et une nouvelle version pour le modèle importé

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

Cette commande importe le package d’exportation de modèle spécifié avec tous les paramètres du modèle et spécifie un nouveau nom et une nouvelle version pour le modèle importé.

Exemple 3 : Importer un modèle avec certaines/toutes les ressources du package exporté lors de la modification du mappage

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"

La première commande crée un objet de mappage de package pour le package stocké sur le chemin spécifié, puis stocke l’objet de mappage de package dans la variable $Mappings.

La deuxième commande obtient un objet de mappage par ID de package et stocke l’objet dans la variable $Mapping.

La troisième commande obtient l’objet de disque dur virtuel nommé VHD01 et stocke l’objet dans la variable $Resource.

La quatrième commande lie le mappage stocké dans $Mapping à l’objet stocké dans $Resource (VHD01).

La cinquième commande définit le fichier de package pour le mappage stocké dans $Mapping.

La dernière commande importe le modèle sur le chemin spécifié avec les mappages spécifiés (dans ce cas, VHD01 importe dans Share01).

Paramètres

-AllowUnencryptedTransfer

Indique que les transferts de fichiers réseau ne nécessitent pas de chiffrement. Si vous autorisez les transferts de fichiers réseau non chiffrés, il peut améliorer les performances si ni l’hôte source ni l’hôte de destination ne nécessitent le chiffrement.

Utilisez ce paramètre pour :

  • Autorisez les transferts de fichiers non chiffrés vers ou hors de la bibliothèque.
  • Autorisez les transferts de fichiers non chiffrés vers, hors ou au sein d’un groupe hôte.
Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom d’un objet VMM.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Overwrite

Indique qu’une opération d’importation ou d’exportation remplace un fichier existant portant le même nom. Ou qu’une opération d’importation remplace un modèle de machine virtuelle ou un objet de modèle de service existant portant le même nom.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-PackageMapping

Spécifie un tableau d’objets de mappage de package.

Type:PackageMapping[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Password

Spécifie une chaîne sécurisée qui contient un mot de passe.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Path

Spécifie le chemin d’accès de destination de l’opération.

Exemples de formats :

  • Chemin d’accès local : -Path "F:\"
  • Chemin d’accès UNC : -Path "\\Library\Templates"
  • Chemin d’accès GUID du volume : -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Chemin VMware ESX : -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Chemin citrix XenServer : -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Release

Spécifie une chaîne qui décrit la mise en production d’une ressource de bibliothèque. VMM crée automatiquement une valeur de mise en production pour chaque ressource importée dans la bibliothèque. Une fois la ressource importée, vous pouvez personnaliser la chaîne.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SettingsIncludePrivate

Indique que les paramètres de modèle sensibles sont inclus dans une opération d’importation ou d’exportation.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-SharePath

Spécifie un chemin d’accès à un partage de bibliothèque valide sur un serveur de bibliothèque existant qui utilise un chemin UNC (Universal Naming Convention).

Exemple de format : -SharePath "\\LibServer01\LibShare"

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-TemplatePackage

Spécifie un package de modèle exporté qui contient des paramètres sérialisés d’un modèle de service ou de machine virtuelle.

Type:Package
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Sorties

SCTemplate

Cette applet de commande retourne un objet SCTemplate.