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.

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

Description

L’applet de commande Import-SCTemplate importe un modèle de machine virtuelle ou un modèle de service dans la bibliothèque Virtual Machine Manager (VMM). 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 du 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 qui a certaines/toutes les ressources dans le 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é au chemin d’accès 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 au chemin d’accès 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 des 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, en dehors ou au sein d’un groupe hôte.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom d’un objet VMM.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageMapping

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

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

-Password

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

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

-Path

Spécifie le chemin de destination de l’opération.

Exemples de formats :

  • Chemin d’accès local : -Path "F:\"
  • Chemin UNC : -Path "\\Library\Templates"
  • Chemin d’accès GUID du volume : -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Chemin d’accès VMware ESX : -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Chemin 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

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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 d’accès UNC (Universal Naming Convention).

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM.

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

Sorties

SCTemplate

Cette applet de commande retourne un objet SCTemplate .