Partager via

Export-SCTemplate

  • Référence
Module:
VirtualMachineManager

Exporte un modèle de la bibliothèque VMM vers le chemin d’accès spécifié.

Syntaxe

Export-SCTemplate
      [-VMTemplate] <Template>
      -Path <String>
      [-SettingsIncludePrivate]
      [-Overwrite]
      [-Password <String>]
      [-IncludeLibraryResources <ItemBase[]>]
      [-AllowUnencryptedTransfer]
      [-IncludeAllLibraryResources]
      [-VMMServer <ServerConnection>]
      [<CommonParameters>]
Export-SCTemplate
      [-ServiceTemplate] <ServiceTemplate>
      -Path <String>
      [-SettingsIncludePrivate]
      [-Overwrite]
      [-Password <String>]
      [-IncludeLibraryResources <ItemBase[]>]
      [-AllowUnencryptedTransfer]
      [-IncludeAllLibraryResources]
      [-VMMServer <ServerConnection>]
      [<CommonParameters>]

Description

L’applet de commande Export-SCTemplate exporte un modèle de la bibliothèque VMM (Virtual Machine Manager) vers le chemin spécifié. Vous pouvez également exporter les objets de bibliothèque sur lesquels dépend le modèle.

Exemples

Exemple 1 : Exporter un modèle de service avec tous ses paramètres

PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> Export-SCTemplate -ServiceTemplate $ServiceTemplate -Path "C:\TemplateExports" -SettingsIncludePrivate -Overwrite

La première commande obtient l’objet de modèle de service nommé ServiceTemplate01 et stocke l’objet dans la variable $ServiceTemplate.

La deuxième commande exporte le modèle de service stocké dans $ServiceTemplate, y compris tous les paramètres, et remplace les packages d’exportation de modèles existants portant le même nom.

Exemple 2 : Exporter plusieurs modèles de service avec tous leurs paramètres

PS C:\> Get-SCServiceTemplate | Export-SCTemplate -Path "C:\TemplateExports" -SettingsIncludePrivate -Overwrite

Cette commande utilise la cmdlet Get-SCServiceTemplate pour obtenir tous les objets de modèle de service. Ensuite, il utilise l’opérateur de pipeline pour envoyer les objets à l’applet de commande Export-SCTemplate , qui exporte les modèles, en remplaçant les fichiers existants.

Exemple 3 : Exporter un modèle de service, y compris ses ressources de bibliothèque dépendantes

PS C:\> $ServiceTemplate = Get-SCServiceTemplate -Name "ServiceTemplate01"
PS C:\> Export-SCTemplate -ServiceTemplate $ServiceTemplate -Path "C:\TemplateExports" -IncludeAllLibraryResources

La première commande obtient l’objet de modèle de service nommé ServiceTemplate01 et stocke l’objet dans la variable $ServiceTemplate.

La deuxième commande exporte ServiceTemplate01 et toutes ses ressources dépendantes de la bibliothèque VMM vers C :\TempalteExports.

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

-IncludeAllLibraryResources

Indique que toutes les dépendances d’un modèle sont exportées à partir de la bibliothèque VMM avec le modèle.

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

-IncludeLibraryResources

Spécifie les ressources de bibliothèque dépendantes à exporter avec un modèle.

Type:ItemBase[]
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

-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

-ServiceTemplate

Spécifie un objet de modèle de service.

Type:ServiceTemplate
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
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

-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

-VMTemplate

Spécifie un objet de modèle VMM utilisé pour créer des machines virtuelles.

Type:Template
Position:0
Valeur par défaut:None
Obligatoire:True
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 .