Import-SCTemplate

Referência

Módulo:: VirtualMachineManager

Importa um modelo de máquina virtual ou modelo de serviço para a biblioteca do 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 um modelo de serviço para a biblioteca do VMM (Virtual Machine Manager). 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 de pacote de modelo armazenado em $Package, incluindo todas as configurações de modelo.

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

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

Esse comando importa o pacote de exportação de modelo especificado com todas as configurações do modelo e especifica um novo nome e 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 armazena o objeto de mapeamento de pacote na variável $Mappings.

O segundo comando obtém um objeto de mapeamento por ID do 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 associa o mapeamento armazenado em $Mapping ao objeto armazenado em $Resource (VHD01).

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

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

Parâmetros

-AllowUnencryptedTransfer

Indica que as transferências de arquivo de rede não exigem criptografia. Se você permitir transferências de arquivo de rede não criptografadas, ele 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 arquivo não criptografadas para a biblioteca ou para fora da biblioteca.
Permitir transferências de arquivo não criptografadas para, fora ou dentro de um grupo de host.

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 arquivo existente com o mesmo nome. Ou que uma operação de importação substitua um modelo de máquina virtual ou objeto de modelo de serviço existente com o mesmo nome.

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

-PackageMapping

Especifica uma matriz de objetos de mapeamento de pacote.

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

-Password

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

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 UNC: -Path "\\Library\Templates"
Caminho guid de volume: -Path "\\?\Volume{4703c1ea-8ae7-11db-b473-00123f7603e3}\"
Caminho do VMware ESX: -Path "\[storage1\]\MyVMwareFolderForVMs\MyVM.vmx"
Caminho do 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 de caracteres que descreve a versã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 for importado, você poderá personalizar a cadeia de caracteres.

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

-SettingsIncludePrivate

Indica que as configurações de modelo confidenciais estão incluídas em uma 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 um compartilhamento de biblioteca válido em um servidor de biblioteca existente que usa um caminho UNC (Convenção Universal de Nomenclatura).

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 serviço ou modelo de máquina virtual.

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

-VMMServer

Especifica um objeto de servidor do VMM.

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

Saídas

SCTemplate

Esse cmdlet retorna um objeto SCTemplate .