Flux de travail

Enchaînez des activités avec les flux de travail PowerShell Universal.

Les flux de travail PowerShell Universal vous permettent d'enchaîner des scripts et des invites d'IA en un seul processus d'automatisation. Ils sont utiles lorsque vous devez transmettre la sortie d'une étape à la suivante, créer des branchements selon les résultats précédents, ou ajouter un traitement assisté par IA entre des étapes d'automatisation.

Les flux de travail peuvent être créés dans la console d'administration et gérés depuis PowerShell. Lors de l'exécution d'un flux de travail, une tâche de flux de travail est créée et peut être surveillée depuis le même historique de tâches utilisé pour les scripts.

Création d'un flux de travail

Pour créer un flux de travail dans la console d'administration, accédez à Automation / Workflows et cliquez sur Create Workflow.

Les flux de travail nécessitent un nom et peuvent optionnellement définir des paramètres. Ces paramètres s'affichent lorsque le flux de travail est démarré manuellement et sont disponibles pour les expressions et les activités pendant l'exécution.

Utilisation du concepteur de flux de travail

Le concepteur de flux de travail fournit un éditeur visuel pour organiser et configurer votre flux de travail. Lorsque vous ouvrez un flux de travail, PSU affiche le concepteur pour cette définition de flux de travail.

Ajout d'activités

PowerShell Universal prend en charge les activités de type script et invite d'IA dans les flux de travail. En coulisses, les flux de travail utilisent également des activités conteneurs, telles que les nœuds organigramme et séquence, pour définir la disposition générale.

Pour ajouter une activité, faites-la glisser depuis le volet d'activités à gauche du concepteur vers une zone de dépôt sur le canevas.

Définition des propriétés d'une activité

Sélectionnez une activité pour modifier ses propriétés dans le volet de droite. Les propriétés disponibles dépendent du type d'activité.

Pour les activités de script, PSU expose les paramètres PowerShell du script en tant que propriétés de l'activité. Cela permet de lier des valeurs fixes ou des expressions d'exécution sans avoir à réécrire le script pour l'utilisation dans un flux de travail.

Utilisation des expressions PowerShell

Certaines propriétés d'activité prennent en charge des expressions PowerShell. Ces expressions sont évaluées au moment de l'exécution et peuvent référencer les valeurs d'entrée du flux de travail et la sortie de l'activité précédente.

Utilisez des expressions lorsque la valeur d'une propriété doit être calculée au moment de l'exécution plutôt que stockée comme une valeur fixe. Par exemple, vous pouvez activer ou désactiver un comportement en fonction d'un paramètre de flux de travail ou sélectionner des valeurs depuis la sortie de l'étape précédente.

Données du flux de travail

Les expressions et les activités peuvent accéder à l'état du flux de travail via des variables intégrées.

Objet Workflow

Utilisez la variable $Workflow dans les expressions PowerShell pour accéder aux valeurs des paramètres du flux de travail.

Par exemple, vous pouvez définir une propriété booléenne en fonction de l'environnement sélectionné.

$Workflow.Environment -eq "Production"

Vous pouvez également transmettre directement un paramètre de flux de travail de type chaîne dans une propriété d'activité.

$Workflow.Environment

Les paramètres de flux de travail sont définis sur le flux de travail lui-même. Utilisez-les pour les valeurs qui doivent être fournies au démarrage du flux de travail, comme un nom d'environnement, une période de rétention ou une cible d'approbation.

PSUItem

La variable $PSUItem donne accès à la sortie de l'activité précédente. Le type de l'objet dépend de ce que cette activité a retourné.

Par exemple, un script peut accepter $PSUItem en entrée.

param($PSUItem)

$PSUItem.MyValue

Vous pouvez également référencer PSUItem dans des invites d'IA.

PSUItem contains a list of processes. Return the process using the most memory as JSON.

Vous pouvez également utiliser $PSUItem ou $Output dans des expressions PowerShell pour modifier le comportement d'une activité en fonction de la sortie de l'activité précédente.

$PSUItem.ProcessMemory -gt 100

Utilisez $PSUItem lorsque vous souhaitez transmettre une sortie structurée d'une activité à la suivante. C'est la principale façon de créer des flux de travail à plusieurs étapes sans stocker un état intermédiaire ailleurs.

Exemple de modèle de flux de travail

Un modèle courant est le suivant :

Exécuter un script pour collecter des données.
Transmettre la sortie à une invite d'IA ou à un autre script.
Utiliser le résultat dans un script final pour effectuer une action.

Par exemple :

Une activité de script retourne une liste de processus.
Une invite d'IA identifie le processus utilisant le plus de mémoire.
Un script final reçoit ce résultat via $PSUItem et envoie une notification.

Cette approche permet de maintenir chaque étape concentrée sur sa tâche et facilite les tests et le dépannage du flux de travail.

Exécution des flux de travail

À la demande

Les flux de travail peuvent être exécutés à la demande en cliquant sur l'icône Lecture dans la console d'administration. Si le flux de travail définit des paramètres, PSU les demande dans la boîte de dialogue d'exécution. Une fois le flux de travail démarré, PSU vous redirige vers la page de tâche du flux de travail.

Planification

Les flux de travail prennent en charge les mêmes options de planification que les scripts, notamment les planifications CRON, ponctuelles et continues. Vous pouvez créer des planifications de flux de travail depuis Automation / Schedules ou en assignant une planification directement au flux de travail.

Utilisez des planifications lorsque le flux de travail doit s'exécuter sans intervention manuelle, par exemple pour un nettoyage nocturne, une validation d'environnement ou une classification périodique assistée par IA.

Invoke-PSUWorkflow

Invoke-PSUWorkflow vous permet d'exécuter des flux de travail depuis PowerShell ou depuis d'autres parties de la plateforme PowerShell Universal. Comme Invoke-PSUScript, vous pouvez fournir des valeurs de paramètres lors de l'invocation du flux de travail.

Gestion des flux de travail avec PowerShell

Vous pouvez gérer les flux de travail via le module Universal en plus de la console d'administration.

Les cmdlets principaux pour les flux de travail sont :

Get-PSUWorkflow
New-PSUWorkflow
Set-PSUWorkflow
Remove-PSUWorkflow
New-PSUWorkflowParameter
New-PSUWorkflowActivity
Invoke-PSUWorkflow

Définition des paramètres de flux de travail

Utilisez New-PSUWorkflowParameter pour définir les métadonnées d'entrée du flux de travail, telles qu'une valeur par défaut, si le paramètre est obligatoire et le texte d'aide affiché aux utilisateurs.

$Parameters = @(
	New-PSUWorkflowParameter -Name Environment -DefaultValue Development -Required -HelpText 'Target environment'
)

Définition des activités dans PowerShell

Utilisez New-PSUWorkflowActivity pour créer des définitions d'activités de flux de travail.

Utilisez -Parameters pour les valeurs littérales.
Utilisez -Expressions pour les expressions PowerShell évaluées au moment de l'exécution.
Pour -Type Script, PSU peut exposer des paramètres dynamiques du script cible.

$Deploy = New-PSUWorkflowActivity -Type Script `
	-Name Deploy `
	-ScriptFullPath 'C:\ProgramData\UniversalAutomation\Repository\scripts\Deploy.ps1' `
	-FailOnScriptError $true

$Root = New-PSUWorkflowActivity -Type Sequence -Name Deployment -Parameters @{
	Activities = @($Deploy)
}

Création d'un flux de travail dans PowerShell

New-PSUWorkflow accepte soit une chaîne de définition brute, soit un bloc de script qui retourne une définition d'activité de flux de travail unique.

$Parameters = @(
	New-PSUWorkflowParameter -Name Environment -DefaultValue Development -Required -HelpText 'Target environment'
)

$Deploy = New-PSUWorkflowActivity -Type Script `
	-Name Deploy `
	-ScriptFullPath 'C:\ProgramData\UniversalAutomation\Repository\scripts\Deploy.ps1' `
	-Expressions @{ Environment = '$Workflow.Environment' }

$Root = New-PSUWorkflowActivity -Type Sequence -Name Deployment -Parameters @{
	Activities = @($Deploy)
}

New-PSUWorkflow -Name ApplicationDeployment -Description 'Deploy an application through a workflow' -WorkflowParameters $Parameters -Definition { $Root }

Surveillance des exécutions de flux de travail

Les exécutions de flux de travail apparaissent dans l'historique des tâches, tout comme les tâches de scripts. Utilisez la page de tâche pour inspecter :

le statut actuel
la sortie de flux
la sortie du pipeline
les erreurs

C'est l'endroit idéal pour dépanner les étapes de flux de travail échouées et vérifier les données transmises entre les activités.

Dépannage

Si une propriété doit être calculée au moment de l'exécution, utilisez une expression plutôt qu'une valeur fixe.
$PSUItem ne contient que la sortie de l'activité précédente. La première activité d'un flux de travail n'aura pas de sortie précédente.
Les propriétés d'activité de script sont basées sur les métadonnées du script cible. Si un paramètre de script n'apparaît pas comme prévu, vérifiez le chemin du script et le nom du paramètre.
Les noms de paramètres d'activité et les clés d'expression doivent correspondre aux propriétés valides pour ce type d'activité.
Si vous avez besoin d'une exécution récurrente, attachez une planification plutôt que d'invoquer manuellement le flux de travail.

Rubriques connexes

PrécédentDéclencheurs SuivantÀ propos

Mis à jour il y a 1 mois

Ce contenu vous a-t-il été utile ?