Compartir a través de

Import-SCTemplate

  • Referencia
Módulo:
VirtualMachineManager

Importa una plantilla de máquina virtual o una plantilla de servicio en la biblioteca VMM.

Sintaxis

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

El cmdlet Import-SCTemplate importa una plantilla de máquina virtual o una plantilla de servicio en la biblioteca de Virtual Machine Manager (VMM). Para exportar una plantilla desde la biblioteca, use Export-SCTemplate.

Ejemplos

Ejemplo 1: Importación de un paquete de plantilla exportado previamente

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

El primer comando obtiene el objeto de paquete de plantilla exportado en la ruta de acceso especificada y almacena el objeto en la variable $Package.

El segundo comando importa el objeto de paquete de plantilla almacenado en $Package, incluida toda la configuración de plantilla.

Ejemplo 2: Importación de un paquete de exportación y especificación de un nuevo nombre y versión para la plantilla importada

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

Este comando importa el paquete de exportación de plantillas especificado con toda la configuración de la plantilla y especifica un nuevo nombre y una versión para la plantilla importada.

Ejemplo 3: Importación de una plantilla que tiene algunos o todos los recursos en el paquete exportado al cambiar la asignación

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"

El primer comando crea un objeto de asignación de paquetes para el paquete almacenado en la ruta de acceso especificada y, a continuación, almacena el objeto de asignación de paquetes en la variable $Mappings.

El segundo comando obtiene un objeto de asignación por identificador de paquete y almacena el objeto en la variable $Mapping.

El tercer comando obtiene el objeto de disco duro virtual denominado VHD01 y almacena el objeto en la variable $Resource.

El cuarto comando enlaza la asignación almacenada en $Mapping al objeto almacenado en $Resource (VHD01).

El quinto comando establece el archivo de paquete para la asignación almacenada en $Mapping.

El último comando importa la plantilla en la ruta de acceso especificada con las asignaciones especificadas (en este caso, VHD01 importa a Share01).

Parámetros

-AllowUnencryptedTransfer

Indica que las transferencias de archivos de red no requieren cifrado. Si permite transferencias de archivos de red sin cifrar, puede mejorar el rendimiento si ni el host de origen ni el host de destino requieren cifrado.

Use este parámetro para:

  • Permitir transferencias de archivos sin cifrar dentro o fuera de la biblioteca.
  • Permitir transferencias de archivos sin cifrar en un grupo host, fuera de él o dentro de él.
Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre de un objeto VMM.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Overwrite

Indica que una operación de importación o exportación sobrescribe un archivo existente con el mismo nombre. O bien, que una operación de importación sobrescribe una plantilla de máquina virtual existente o un objeto de plantilla de servicio con el mismo nombre.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PackageMapping

Especifica una matriz de objetos de asignación de paquetes.

Tipo:PackageMapping[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Password

Especifica una cadena segura que contiene una contraseña.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Path

Especifica la ruta de acceso de destino para la operación.

Formatos de ejemplo:

  • Ruta de acceso local: -Path "F:\"
  • Ruta de acceso UNC: -Path "\\Library\Templates"
  • Ruta de acceso GUID de volumen: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Ruta de acceso de VMware ESX: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Ruta de acceso de Citrix XenServer: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Release

Especifica una cadena que describe la versión de un recurso de biblioteca. VMM crea automáticamente un valor de versión para cada recurso importado en la biblioteca. Una vez importado el recurso, puede personalizar la cadena.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SettingsIncludePrivate

Indica que la configuración de plantilla confidencial se incluye en una operación de importación o exportación.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SharePath

Especifica una ruta de acceso a un recurso compartido de biblioteca válido en un servidor de biblioteca existente que usa una ruta de acceso de convención de nomenclatura universal (UNC).

Formato de ejemplo: -SharePath "\\LibServer01\LibShare"

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TemplatePackage

Especifica un paquete de plantilla exportado que contiene la configuración serializada de una plantilla de servicio o máquina virtual.

Tipo:Package
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

SCTemplate

Este cmdlet devuelve un objeto SCTemplate.