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.

Limitações

Nenhuma.

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. Para conhecer as etapas gerais, consulte Criar uma definição de propriedade personalizada de ação do vRealize Orchestrator.

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.

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. Caminho para o arquivo PowerShell como um recurso carregado no vRealize Orchestrator. Por exemplo,

Configuração do blueprint

Para adicionar a propriedade personalizada à guia Propriedades do blueprint, consulte Adicionar uma propriedade personalizada ou um grupo de propriedades como uma propriedade de máquina de blueprint.