Import-SCTemplate
Importa una plantilla de máquina virtual o una plantilla de servicio en la biblioteca 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
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 dentro, fuera o dentro de un grupo host.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifica el nombre de un objeto de VMM.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageMapping
Especifica una matriz de objetos de asignación de paquetes.
Type: | PackageMapping[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Password
Especifica una cadena segura que contiene una contraseña.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 del 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\]"
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SettingsIncludePrivate
Indica que la configuración de plantilla confidencial se incluye en una operación de importación o exportación.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 la convención de nomenclatura universal (UNC).
Formato de ejemplo: -SharePath "\\LibServer01\LibShare"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TemplatePackage
Especifica un paquete de plantilla exportado que contiene la configuración serializada de una plantilla de servicio o máquina virtual.
Type: | Package |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMMServer
Especifica un objeto de servidor VMM.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Salidas
SCTemplate
Este cmdlet devuelve un objeto SCTemplate .