Vous ajoutez une propriété personnalisée pour exécuter un script PowerShell lorsque vous voulez utiliser un script pour récupérer des données afin de remplir la propriété personnalisée sur le formulaire de demande. La propriété personnalisée de script PowerShell utilise une action de vRealize Orchestrator pour exécuter le script et récupérer les valeurs.

Par exemple, en tant qu'administrateur cloud, vous avez un script PowerShell qui récupère les ID d'utilisateurs dans le service d'annuaire Active Directory enregistré avec vRealize Automation. L'objectif du script est de récupérer et d'afficher John Smith lorsque la valeur réelle dans Active Directory est JSmith01.

L'utilisation d'une action de script PowerShell a pour avantage d'inclure un emplacement central pour le script. Vous avez le choix entre stocker le script sur un serveur central, puis l'exécuter sur les machines virtuelles cibles, ou le stocker dans vRealize Orchestrator et l'exécuter sur les machines cibles. Un emplacement central réduit le temps de maintenance. Stocker les scripts dans vRealize Orchestrator lorsque vous avez configuré la sauvegarde et la restauration vous garantit que vous pourrez restaurer les scripts en cas de défaillance du système.

Limitations

Aucune.

Conditions préalables

Assurez-vous que vous disposez d'un script PowerShell opérationnel qui renvoie les valeurs de paires de clés. Le script doit être disponible sur un serveur accessible ou être téléchargé dans vRealize Orchestrator.

Valeurs de configuration d'une propriété personnalisée

Vous utilisez ces options pour créer la propriété personnalisée. Pour connaître les étapes générales, reportez-vous à la section Créer une définition de propriété personnalisée d'action de vRealize Orchestrator.

Tableau 1. Valeurs de configuration d'une propriété personnalisée de script PowerShell

Option

Valeur

Nom

Vous pouvez utiliser n'importe quelle chaîne.

Type de données

Chaîne

Afficher comme

Liste déroulante

Valeurs

Externe

Dossier Action

com.vmware.vra.powershell

Action de script

Sélectionnez une action en fonction de l'emplacement du script PowerShell.

  • Si le script PowerShell se trouve sur un serveur central, utilisez executeExternalPowerShellScriptOnHostByName.

  • Si le script PowerShell est téléchargé dans vRealize Orchestrator, utilisez executePowershellScriptFromResourceOnHostByName.

Ces actions de script sont des exemples de scripts. Vous pouvez créer des actions spécifiques pour votre environnement.

Paramètres d'entrée

Configurez les paramètres d'entrée en fonction de l'action sélectionnée.

Définir les paramètres

  • Si vous utilisez executeExternalPowerShellScriptOnHostByName :

    • hostName. Nom du serveur central sur lequel se trouve le script.

    • externalPowershellScript. Chemin d'accès au fichier PowerShell sur l'hôte.

    • Arguments. Paramètres à transférer au script. Les arguments sont séparés par des virgules. Par exemple Argument1,Arguement2.

  • Si vous utilisez executePowershellScriptFromResourceOnHostByName :

    • vRealize Orchestrator. Nom de l'instance de vRealize Orchestrator que vous utilisez en tant qu'hôte.

    • scriptResourcePath. Chemin d'accès au fichier PowerShell sur l'hôte.

    • scriptResourceName. Chemin d'accès au fichier PowerShell en tant que ressource téléchargée dans vRealize Orchestrator.

Configuration du Blueprint

Pour ajouter la propriété personnalisée à l'onglet propriétés du Blueprint, reportez-vous à la rubrique Ajouter une propriété personnalisée ou un groupe de propriétés en tant que propriété de machine du Blueprint.