> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/fr/automatisation/jobs.md). # Tâches Suivez les tâches PowerShell Universal, examinez les sorties et les statuts, configurez les garde-fous de sortie et le caviardage des données sensibles, et invoquez des tâches à partir de scripts, d'a Les tâches sont des exécutions de scripts. Affichez-les sous **Exécuter > Tâches** pour examiner le statut, la sortie des flux, la sortie de pipeline, les erreurs, les demandes de rétroaction, la version du script et les métadonnées de la tâche. ## Sortie La sortie des flux PowerShell, incluant les enregistrements d'information, d'hôte, d'erreur, d'avertissement et détaillés, est affichée dans le volet de sortie de la tâche. Les objets écrits dans le pipeline sont stockés en CliXml et sont disponibles à partir de l'onglet **Sortie de pipeline**. Configurez **Comportement en cas de sortie de tâche volumineuse** et **Taille maximale de la sortie de tâche (Ko)** sous **Engrenage Paramètres > Automatisation** pour protéger l'instance contre une sortie excessive. Le maximum par défaut est de **10 240 Ko**; définissez-le à `0` pour désactiver la limite. | Comportement | Résultat | | ------------ | ---------------------------------------------------------------------------------- | | Avertir | Conserve la sortie et crée un avertissement. Il s'agit du comportement par défaut. | | Tronquer | Stocke la sortie seulement jusqu'à la limite. | | Compresser | Stocke la sortie excédentaire sous forme compressée. | | Ignorer | N'applique pas la limite ni le comportement d'avertissement. | Vous pouvez aussi rejeter la sortie de pipeline pour un script individuel avec son paramètre **Rejeter le pipeline**. ### Caviarder la sortie sensible des tâches Activez **Caviarder la sortie sensible des tâches** sous **Engrenage Paramètres > Automatisation** pour masquer des valeurs de la sortie de tâche avant que celle-ci soit journalisée ou enregistrée. Le caviardage est désactivé par défaut. Lorsque l'option est activée, PowerShell Universal remplace les valeurs correspondantes par `********` pour les noms de clés sensibles intégrés, dont `password`, `secret`, `client_secret`, `api_key`, `access_token`, `token`, `authorization`, `credential` et `connection_string`. Il reconnaît les formats clé-valeur courants comme JSON, les données de formulaire HTTP ou de chaîne de requête, et la sortie délimitée par deux-points. ```powershell Write-Host '{"password": "MyPassword"}' # Job output: {"password": "********"} Write-Host 'client_secret=MyClientSecret' # Job output: client_secret=******** Write-Host 'Authorization: [value]' # Job output: Authorization: ******** ``` Ajoutez des noms de champs propres à votre organisation avec **Clés de sortie sensibles supplémentaires** sur la même page de paramètres. Ces clés utilisent les mêmes motifs de correspondance que les clés intégrées. Le caviardage est un filet de sécurité de la sortie au mieux des capacités, et non un scanneur de secrets complet. Il ne masque pas les valeurs qui ne sont pas émises sous forme de paires clé-valeur reconnues, y compris les valeurs intégrées dans un formatage d'objet personnalisé ou récupérées auprès d'un fournisseur de secrets. N'écrivez pas de secrets dans la sortie des tâches. ## Version du script Chaque tâche enregistre la version résolue du script qui l'a démarrée. Repérez l'étiquette **Version du script** dans l'en-tête de la tâche pour identifier la source utilisée pour cette exécution. * Les scripts de dépôt synchronisés avec Git enregistrent le SHA de commit Git résolu. * Les scripts de commande de module enregistrent la version de module résolue. La valeur enregistrée demeure associée à la tâche après une modification du script ou du module, ce qui fournit une piste d'audit au moment de l'exécution. Les tâches relancées utilisent la version de script actuellement résolue lorsqu'elle est disponible; sinon, elles conservent la version enregistrée d'origine. ## Statut et rétroaction Les tâches peuvent être **En file d'attente**, **En cours d'exécution**, **Erreur**, **Avertissement**, **Échouée** ou **En attente de rétroaction**. Un appel `Read-Host` place une tâche en attente de rétroaction; répondez à partir de la page de la tâche. Utilisez `Read-Host -AsSecureString` pour la saisie d'un mot de passe. ## Invoquer des tâches Utilisez `Invoke-PSUScript` pour démarrer une tâche et `Wait-PSUJob` pour l'attendre. À l'extérieur de PowerShell Universal, utilisez un jeton d'appli valide. ```powershell Invoke-PSUScript -Script 'Script1.ps1' -RequiredParameter 'Hello' | Wait-PSUJob ``` Récupérez la sortie de pipeline avec `Get-PSUJobPipelineOutput`. ```powershell Get-PSUJobPipelineOutput -JobId 10 ``` Utilisez `-Integrated` uniquement depuis l'intérieur de PowerShell Universal. Les applis peuvent l'utiliser avec `-Wait` pour transmettre les interactions `Write-Progress` et `Read-Host`. ```powershell New-UDButton -Text 'Run script' -OnClick { Invoke-PSUScript -Name 'AppExample.ps1' -Integrated -Wait } -ShowLoading ``` ## ID d'exécution de tâche Par défaut, les tâches utilisent des ID numériques incrémentiels. Activez `JobRunID` pour utiliser un `RunID` basé sur un GUID pour les recherches de tâches. ```powershell Set-PSUSetting -JobRunId ``` ## API * `Invoke-PSUScript` * `Get-PSUJob` * `Get-PSUJobOutput` * `Get-PSUJobPipelineOutput` * `Wait-PSUJob` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell-universal/fr/automatisation/jobs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.