Partilhar via

Import-SCTemplate

  • Referência
Módulo:
VirtualMachineManager

Importa um modelo de máquina virtual ou modelo de serviço para a biblioteca do VMM.

Sintaxe

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

O cmdlet Import-SCTemplate importa um modelo de máquina virtual ou modelo de serviço para a biblioteca do Virtual Machine Manager (VMM). Para exportar um modelo da biblioteca, use Export-SCTemplate.

Exemplos

Exemplo 1: Importar um pacote de modelo exportado anteriormente

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

O primeiro comando obtém o objeto de pacote de modelo exportado no caminho especificado e armazena o objeto na variável $Package.

O segundo comando importa o objeto do pacote de modelo armazenado no $Package, incluindo todas as configurações do modelo.

Exemplo 2: Importar um pacote de exportação e especificar um novo nome e uma nova versão para o modelo importado

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

Este comando importa o pacote de exportação de modelo especificado com todas as configurações do modelo e especifica um novo nome e uma nova versão para o modelo importado.

Exemplo 3: Importar um modelo que tenha alguns/todos os recursos no pacote exportado ao alterar o mapeamento

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"

O primeiro comando cria um objeto de mapeamento de pacote para o pacote armazenado no caminho especificado e, em seguida, armazena o objeto de mapeamento de pacote na variável $Mappings.

O segundo comando obtém um objeto de mapeamento por ID de pacote e armazena o objeto na variável $Mapping.

O terceiro comando obtém o objeto de disco rígido virtual chamado VHD01 e armazena o objeto na variável $Resource.

O quarto comando vincula o mapeamento armazenado em $Mapping ao objeto armazenado em $Resource (VHD01).

O quinto comando define o arquivo de pacote para o mapeamento armazenado no $Mapping.

O último comando importa o modelo no caminho especificado com os mapeamentos especificados (neste caso, o VHD01 importa para Share01).

Parâmetros

-AllowUnencryptedTransfer

Indica que as transferências de arquivos de rede não exigem criptografia. Se você permitir transferências de arquivos de rede não criptografados, isso poderá melhorar o desempenho se nem o host de origem nem o host de destino exigirem criptografia.

Use este parâmetro para:

  • Permitir transferências de ficheiros não encriptados para dentro ou para fora da biblioteca.
  • Permitir transferências de ficheiros não encriptados para, para fora ou dentro de um grupo de anfitriões.
Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Overwrite

Indica que uma operação de importação ou exportação substitui um arquivo existente com o mesmo nome. Ou que uma operação de importação substitui um modelo de máquina virtual existente ou um objeto de modelo de serviço com o mesmo nome.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PackageMapping

Especifica uma matriz de objetos de mapeamento de pacote.

Tipo:PackageMapping[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Password

Especifica uma cadeia de caracteres segura que contém uma senha.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Path

Especifica o caminho de destino para a operação.

Exemplos de formatos:

  • Caminho local: -Path "F:\"
  • Caminho UNC: -Path "\\Library\Templates"
  • Caminho do GUID do volume: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • Caminho VMware ESX: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Caminho do Citrix XenServer: -Path "Local storage\[99b6212f-b63d-c676-25f9-d6c460992de7\]"
Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Release

Especifica uma cadeia de caracteres que descreve a liberação de um recurso de biblioteca. O VMM cria automaticamente um valor de versão para cada recurso importado para a biblioteca. Depois que o recurso tiver sido importado, você poderá personalizar a cadeia de caracteres.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SettingsIncludePrivate

Indica que as configurações de modelo confidenciais estão incluídas em uma operação de importação ou exportação.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SharePath

Especifica um caminho para um compartilhamento de biblioteca válido em um servidor de biblioteca existente que usa um caminho UNC (Convenção de Nomenclatura Universal).

Exemplo de formato: -SharePath "\\LibServer01\LibShare"

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TemplatePackage

Especifica um pacote de modelo exportado que contém configurações serializadas de um modelo de serviço ou máquina virtual.

Tipo:Package
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

SCTemplate

Este cmdlet retorna um objeto SCTemplate.