Você adiciona uma propriedade personalizada para executar um script PowerShell quando deseja usar um script para recuperar dados de modo a preencher a propriedade personalizada no formulário de solicitação. A propriedade personalizada de script PowerShell usa uma ação do vRealize Orchestrator para executar o script e recuperar os valores.

Por exemplo, como administrador de nuvem, você tem um script PowerShell que recupera IDs de usuário do Active Directory que está registrado no vRealize Automation. A intenção do script é recuperar e exibir John Smith quando o valor real no Active Directory é JSmith01.

Uma vantagem de usar a ação de script PowerShell inclui um local central para o script. Você pode armazenar o script em um servidor central e executá-lo em máquinas virtuais de destino ou pode armazená-lo no vRealize Orchestrator e executá-lo nas máquinas de destino. Um local central diminui o tempo de manutenção. Armazenar os scripts no vRealize Orchestrator quando o backup e a restauração estão configurados garante que seja possível restaurar os scripts se ocorrer uma falha no sistema.

Pré-requisitos

Verifique se você tem um script PowerShell operacional que retorna valores de pares de chaves. O script deve estar disponível em um servidor acessível ou deve estar carregado no vRealize Orchestrator.

Valores de configuração da propriedade personalizada

Você pode usar essas opções para criar a propriedade personalizada.

Tabela 1. Valores de configuração da propriedade personalizada de script PowerShell
Opção Valor
Nome É possível usar qualquer cadeia de caracteres.
Tipo de dados Cadeia de caracteres
Exibir como Lista suspensa
Valores Externo
Pasta de ações com.vmware.vra.powershell
Ação de script Selecione uma ação com base em onde o script PowerShell está localizado.
  • Se o script PowerShell estiver em um servidor central, use executeExternalPowerShellScriptOnHostByName.
  • Se o script PowerShell estiver carregado no vRealize Orchestrator, use executePowershellScriptFromResourceOnHostByName.

Essas ações de script são scripts de exemplo. Você pode criar ações específicas para o seu ambiente.

O script modelo do PowerShell Resources/Sample/vRA/PowerShell/countries.ps1 é fornecido no cliente do vRealize Orchestrator como referência para uso com a ação executePowershellScriptFromResourceOnHostByName.

Parâmetros de entrada Configure os parâmetros de entrada com base na ação selecionada.

Definir parâmetros

  • Se você usar executeExternalPowerShellScriptOnHostByName:
    • hostName. Nome do servidor central no qual o script está localizado.
    • externalPowershellScript. Caminho para o arquivo PowerShell no host.
    • Argumentos. Parâmetros a serem transmitidos ao script. Os argumentos são separados por vírgulas. Por exemplo, Argument1,Arguement2.
  • Se você usar executePowershellScriptFromResourceOnHostByName:
    • vRealize Orchestrator. Nome da instância do vRealize Orchestrator que você está usando como o host.
    • scriptResourcePath. Caminho para o arquivo PowerShell no host.
    • scriptResourceName. Percurso para o arquivo PowerShell como um recurso carregado no vRealize Orchestrator.

Configuração do blueprint

Você pode adicionar uma propriedade personalizada à guia Propriedades do blueprint para associar a propriedade ao blueprint geral.