Vous pouvez exécuter des workflows pour générer des actions basées sur un script PowerShell ou un cmdlet PowerShell. Vous pouvez utiliser les actions générées en tant que blocs constitutifs pour des workflows personnalisés.

Générer une action depuis un script PowerShell

Vous pouvez exécuter un workflow pour générer une action depuis un script PowerShell. Vous pouvez en outre générer un échantillon de workflow qui peut exécuter l'action générée.

Vous pouvez personnaliser le script d'une action que vous générez en utilisant des espaces réservés. Pour chaque espace, le workflow crée un paramètre d'action de type string dans l'action générée. Lorsque vous exécutez une action, vous pouvez indiquer une valeur réelle en tant que paramètre d'action pour remplacer l'espace réservé.

Conditions préalables

  • Vérifiez que vous êtes connecté à Automation Orchestrator Client en tant qu'administrateur.
  • Vérifiez que vous disposez d'une connexion à un hôte PowerShell à partir de la vue Inventaire.

Procédure

  1. Dans le client Automation Orchestrator, accédez à Bibliothèque > Workflows et entrez les balises powershell et generate dans la zone de recherche des workflows.
  2. Localisez le workflow Générer une action depuis un script PowerShell et cliquez sur Exécuter.
  3. Dans l'onglet Script, zone de texte Script, entrez ou collez le script PowerShell depuis lequel vous souhaitez générer l'action.
    Note : Vous pouvez utiliser {#ParamName#} en tant qu'espace réservé pour une entrée d'utilisateur. Si l'espace réservé est de type string, vous devez utiliser des guillemets doubles pour transférer la valeur de l'espace réservé vers l'action.
    Le script suivant donne un exemple de la manière de mettre en relation un paramètre d'action généré et un paramètre de script. 
    param($name={#ParamName#})
echo $name;
  4. Dans l'onglet Action, zone de texte Nom, entrez un nom pour l'action à générer, puis sélectionnez un module existant dans lequel générer l'action.
  5. Dans l'onglet Workflow, précisez si vous souhaitez ou non générer un workflow.
    Option Description
    Oui Génère un échantillon de workflow qui peut exécuter l'action générée. Sélectionnez le dossier dans lequel le workflow doit être généré.
    Note : Le nom des workflows générés consiste en une chaîne prédéfinie comportant le script Invoke et le nom de l'action générée.
    Non Un échantillon de workflow n'est pas généré.
  6. Cliquez sur Envoyer pour exécuter le workflow.

Que faire ensuite

Vous pouvez intégrer l'action générée aux workflows personnalisés.

Générer une action pour un cmdlet PowerShell

Vous pouvez exécuter un workflow pour générer une action pour un cmdlet PowerShell et un ensemble de paramètres. Cette action permet d'utiliser la fonctionnalité PowerShell dans Automation Orchestrator. Vous pouvez éventuellement générer un échantillon de workflow qui exécute l'action générée.

Vous pouvez utiliser de nombreux types de données avec le moteur du script PowerShell. Parmi les types de données que vous pouvez utiliser figurent les types primitifs tels que Integer, Boolean, Char et tout type disponible sous l'extension .NET ou tout type défini par l'utilisateur. Lorsque vous générez des actions en fonction des définitions de la cmdlet PowerShell, les paramètres d'entrée et de sortie de la cmdlet sont représentés par les types pris en charge par la plate-forme Automation Orchestrator. Le plug-in PowerShell définit le mappage des types. En général, les types primitifs sont mappés aux types Automation Orchestrator correspondants et les types complexes sont représentés par l'objet PowerShellRemotePSObject.

Conditions préalables

  • Vérifiez que vous êtes connecté à Automation Orchestrator Client en tant qu'administrateur.
  • Vérifiez que vous disposez d'une connexion à un hôte PowerShell à partir de la vue Inventaire.

Procédure

  1. Dans le client Automation Orchestrator, accédez à Bibliothèque > Workflows et entrez les balises powershell et generate dans la zone de recherche des workflows.
  2. Localisez le workflow Générer une action pour une cmdlet PowerShell et cliquez sur Exécuter.
  3. Dans l'onglet Cmdlet, sélectionnez une cmdlet PowerShell à exécuter lors de l'utilisation de l'action que vous générez.
  4. Sélectionnez un jeu de paramètres pour le cmdlet.
    Les valeurs de définition du jeu de paramètres apparaissent dans la zone de texte Définition du jeu de paramètres.
    Note : Vous ne pouvez pas modifier les valeurs de définition du jeu de paramètres en modifiant la chaîne dans la zone de texte Définition du jeu de paramètres. Vous pouvez revoir la chaîne afin d'obtenir des informations concernant les paramètres contenus dans le jeu de paramètres.
  5. Dans l'onglet Action, zone de texte Nom, entrez un nom pour l'action à générer, puis sélectionnez un module existant dans lequel générer l'action.
  6. Dans l'onglet Workflow, précisez si vous souhaitez ou non générer un workflow.
    Option Description
    Oui Génère un échantillon de workflow qui peut exécuter l'action générée. Sélectionnez le dossier dans lequel le workflow doit être généré.
    Note : Le nom des workflows générés consiste en une chaîne prédéfinie comportant le cmdlet Exécuter et le nom de l'action générée.
    Non Un échantillon de workflow n'est pas généré.
  7. Cliquez sur Exécuter.

Que faire ensuite

Vous pouvez intégrer l'action générée aux workflows personnalisés.

Transmission des résultats des appels entre actions

Le plug-in PowerShell prend en charge, sous forme de paramètre, la transmission des résultats d'un appel de script PowerShell à un autre. Pour que les résultats soient transmis correctement, les deux appels doivent avoir lieu dans la même session.