Import-SCTemplate
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 -SettingsIncludePrivateLa 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 .