VMwareOs cmdlets do.Image Builder são implementados como cmdlets do Microsoft PowerShell e incluídos em PowerCLI. Os usuários dos cmdlets do VMware.Image Builder podem aproveitar todos os recursos do PowerCLI.

Os usuários experientes do PowerShell podem usar os cmdlets VMware.Image Builder assim como outros cmdlets do PowerShell. Se você for novo no PowerShell e no PowerCLI, siga estas dicas.

Você pode digitar cmdlets, parâmetros e valores de parâmetros no shell PowerCLI.

  • Obtenha ajuda para qualquer cmdlet executando Get-Help cmdlet_name.
  • Lembre-se de que o PowerShell não diferencia maiúsculas de minúsculas.
  • Use a conclusão de tabulação para nomes de cmdlets e nomes de parâmetros.
  • Formate qualquer variável e saída de cmdlet usando Format-List ou Format-Table ou suas formas abreviadas fl ou ft. Consulte Get-Help Format-List.
  • Use caracteres curinga para pesquisar e filtrar VIBs e perfis de imagem. Todas as expressões curinga são suportadas.

Passando parâmetros por nome

Você pode passar parâmetros por nome na maioria dos casos e colocar valores de parâmetros entre aspas duplas. 

Add-EsxSoftwarePackage -ImageProfile profile42 -SoftwarePackage "partner package 35"

Passando parâmetros como objetos

Você pode passar parâmetros como objetos se quiser fazer scripts e automação. Você pode usar a técnica com cmdlets que retornam vários objetos ou com cmdlets que retornam um único objeto.

  1. Associe a saída de um cmdlet que retorna vários objetos a uma variável. 
    $profs = Get-EsxImageProfile
  2. Ao executar o cmdlet que precisa do objeto como entrada, acesse o objeto por posição, com a lista começando com 0. 
    Add-EsxSoftwarePackage -ImageProfile $profs[4] -SoftwarePackage partner-pkg

O exemplo adiciona o pacote de software especificado ao quinto perfil de imagem na lista retornada por Get-EsxImageProfile.

A maioria dos exemplos na documentação do vCenter Server Instalação e configuração passa parâmetros por nome. vSphere ESXi Image Builder Fluxos de trabalho com PowerCLI cmdlets inclui exemplos que passam parâmetros como objetos.

VMwareVisão geral dos cmdlets do.ImageBuilder

O componente VMware.Image Builder do VMware PowerCLI fornece cmdlets para gerenciar VIBs, perfis de imagem e outros conteúdos em depósitos de software.

vSphere A versão 7.0 e posterior apresenta novas maneiras de empacotar VIBs junto com boletins e patches herdados, e os depósitos de software contêm imagens de base, complementos e componentes do fornecedor, juntamente com VIBs e perfis de imagem. O VMware PowerCLI 12.0 e versões posteriores fornecem cmdlets que funcionam com o novo conteúdo em depósitos de software.

VMware.ImageBuilder inclui os seguintes cmdlets.
Observação: Ao executar os cmdlets VMware.ImageBuilder, forneça todos os parâmetros na linha de comando ao invocar o cmdlet. Não é recomendado fornecer parâmetros no modo interativo.
Execute Get-Help cmdlet_name no prompt PowerCLI para obter informações de referência detalhadas.
Tabela 1. VMwareCmdlets.ImageBuilder usados com conteúdo herdado em depósitos de software
Cmdlet Descrição
Add-EsxSoftwareDepot Adiciona o depósito de software ou o arquivo ZIP no local especificado ao seu ambiente atual. Baixa metadados do depósito e analisa VIBs para dependências.
Remove-EsxSoftwareDepot Desconecta-se do depósito de software especificado.
Get-EsxSoftwareDepot Retorna uma lista de depósitos de software que estão no ambiente atual. Se você quiser examinar e gerenciar perfis de imagem e VIBs, deverá primeiro adicionar o depósito de software correspondente ao seu ambiente.
Get-EsxSoftwarePackage Retorna uma lista de objetos de pacote de software (VIBs). Use as opções deste cmdlet para filtrar os resultados.
Get-EsxImageProfile Retorna uma matriz de objetos ImageProfile de todos os depósitos adicionados no momento.
New-EsxImageProfile Cria um novo perfil de imagem. Na maioria dos casos, é recomendável criar um novo perfil clonando um perfil existente. Consulte Clone um perfil de imagem com PowerCLI cmdlets.
Set-EsxImageProfile Modifica um objeto ImageProfile local e executa testes de validação no perfil modificado. O cmdlet retorna o objeto modificado, mas não o mantém.
Export-EsxImageProfile Exporta um perfil de imagem como uma imagem ISO ESXi para instalação do ESXi ou como um arquivo ZIP.
Compare-EsxImageProfile Retorna uma estrutura ImageProfileDiff que mostra se os dois perfis têm a mesma lista VIB e o mesmo nível de aceitação. Consulte Trabalhando com níveis de aceitação.
Remove-EsxImageProfile Remove o perfil de imagem do depósito de software.
Add-EsxSoftwarePackage Adiciona um ou mais novos pacotes (VIBs) a um perfil de imagem existente.
Remove-EsxSoftwarePackage Remove um ou mais pacotes (VIBs) de um perfil de imagem.
Set-ESXImageProfileAssociation Associa o perfil de imagem especificado ao sistema ESXi especificado.
Tabela 2. VMwareCmdlets.ImageBuilder usados com novo conteúdo em depósitos de software
Cmdlet Descrição
Get-DepotAddons Recupera uma matriz de objetos que fornecem informações básicas sobre complementos em um depósito de software.
Get-DepotBaseImages Recupera uma matriz de objetos que fornecem informações básicas sobre imagens base em um depósito de software.
Get-DepotComponents Recupera uma matriz de objetos que fornecem informações básicas sobre componentes em um depósito de software.
Get-DepotInfo Recupera informações básicas sobre o depósito de software localizado no caminho do arquivo ou endereço de URL especificado.
Get-DepotVibs Recupera uma matriz de objetos que fornecem informações básicas sobre VIBs em um depósito de software.
New-IsoImage Gera uma imagem ISO usando o depósito de software especificado e a especificação de software no caminho do arquivo especificado.
New-PxeImage Gera uma imagem PXE usando o depósito de software e a especificação de software especificados no caminho do arquivo especificado.