Partilhar via

Import-SCTemplate

  • Referência
Módulo:
VirtualMachineManager

Importa um modelo de máquina virtual ou modelo de serviço para a 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

O cmdlet Import-SCTemplate importa um modelo de máquina virtual ou modelo de serviço na biblioteca Virtual Machine Manager (VMM). Para exportar um modelo da biblioteca, utilize exporte-SCTemplate.

Exemplos

Exemplo 1: Importar um pacote de modelo previamente exportado

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 de pacote de modelo armazenado em $Package, incluindo todas as definições do modelo.

Exemplo 2: Importar um pacote de exportação e especificar um novo nome e libertaçã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 definições do modelo e especifica um novo nome e lançamento para o modelo importado.

Exemplo 3: Importar um modelo que tenha alguns/todos os recursos no pacote exportado enquanto muda 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 liga o mapeamento armazenado em $Mapping ao objeto armazenado em $Resource (VHD01).

O quinto comando define o ficheiro de pacote para o mapeamento armazenado em $Mapping.

O último comando importa o modelo na trajetória especificada com os mapeamentos especificados (neste caso, as importações de VHD01 para share01).

Parâmetros

-AllowUnencryptedTransfer

Indica que as transferências de ficheiros de rede não requerem encriptação. Se permitir transferências de ficheiros de rede não encriptadas, pode melhorar o desempenho se nem o anfitrião de origem nem o anfitrião de destino necessitarem de encriptação.

Utilize este parâmetro para:

  • Permitir transferências de ficheiros não encriptadas para dentro ou fora da biblioteca.
  • Permitir transferências de ficheiros não encriptadas para dentro, fora ou dentro de um grupo anfitrião.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Especifica o nome de um objeto VMM.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PackageMapping

Especifica uma variedade de objetos de mapeamento de pacotes.

Type:PackageMapping[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Password

Especifica uma cadeia segura que contém uma palavra-passe.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

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

Formatos de exemplo:

  • Caminho local: -Path "F:\"
  • Caminho da UNC: -Path "\\Library\Templates"
  • Percurso GUID de volume: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
  • VMware ESX caminho: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
  • Caminho 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 uma cadeia que descreve a libertação de um recurso de biblioteca. A VMM cria automaticamente um valor de libertação para cada recurso importado para a biblioteca. Depois de importar o recurso, pode personalizar a cadeia.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SettingsIncludePrivate

Indica que as definições sensíveis do modelo estão incluídas numa operação de importação ou exportação.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SharePath

Especifica um caminho para uma partilha de biblioteca válida num servidor de biblioteca existente que usa um caminho da Convenção Universal de Nomeação (UNC).

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TemplatePackage

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

Type:Package
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Saídas

SCTemplate

Este cmdlet devolve um objeto SCTemplate .