> 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/tests.md).

# Tests

Exécutez et examinez des suites de tests Pester directement dans PowerShell Universal, en effectuant le suivi des résultats historiques des fichiers de test individuels et des exécutions de test compl

> Cette fonctionnalité nécessite une [licence](/powershell-universal/fr/licensing.md).

PowerShell Universal s'intègre à [Pester](https://pester.dev/) pour exécuter des suites de tests à partir de votre dépôt et conserver leurs résultats. Utilisez **Run > Tests** pour découvrir les fichiers de test, démarrer des exécutions, les planifier et examiner les résultats historiques.

## Découverte des tests

PowerShell Universal analyse le dépôt de façon récursive à la recherche de fichiers nommés `*.tests.ps1`. Les fichiers découverts apparaissent dans l'onglet **Test Files**. Créez ou modifiez les fichiers à partir de **Build > Scripts**, puis actualisez les fichiers de test lorsque le contenu du dépôt change.

Utilisez la vue par dossier pour parcourir les fichiers de test découverts selon leurs dossiers de dépôt. Sélectionnez un dossier pour limiter la liste de fichiers à cet emplacement, ou sélectionnez **Tests** pour revenir à tous les fichiers.

## Préparer un environnement d'exécution

Installez Pester dans chaque environnement d'exécution qui exécutera des tests. Une exécution échoue lorsque `Invoke-Pester` n'est pas disponible dans l'environnement sélectionné.

Les variables d'environnement configurées pour l'environnement d'exécution sélectionné sont disponibles pendant l'exécution de Pester. Cela permet aux tests d'utiliser des valeurs de configuration sans les coder en dur dans les fichiers de test. Traitez les valeurs sensibles comme des secrets et récupérez-les au moyen de la configuration PowerShell Universal appropriée.

## Exécuter des tests à partir de la console d'administration

1. Allez à **Run > Tests**.
2. Sélectionnez **Run Test** pour un fichier, ou **Run All Tests** pour exécuter les fichiers de test découverts.
3. Choisissez l'identifiant, l'environnement d'exécution et l'ordinateur ou le groupe d'ordinateurs à utiliser.
4. Sélectionnez **Run**. L'exécution s'ouvre dans la vue des résultats pendant qu'elle est en file d'attente ou en cours.

Vous pouvez exécuter un fichier de test individuel, un dossier de dépôt ou un chemin avec caractère générique. Lorsqu'un dossier est sélectionné, PowerShell Universal exécute les fichiers `*.tests.ps1` et `*.test.ps1` correspondants qui s'y trouvent.

## Exécuter des tests avec PowerShell

Utilisez `Invoke-PSUTest` pour démarrer une exécution Pester à partir d'un script, d'un terminal ou d'un flux de travail d'automatisation. Passez un chemin ou un objet `TestFile`.

```powershell
Invoke-PSUTest -Path '.\tests\api.tests.ps1'
```

Ciblez un sous-ensemble de tests Pester à l'aide d'étiquettes, d'étiquettes exclues ou de noms de tests complets.

```powershell
Invoke-PSUTest -Path '.\tests\api.tests.ps1' `
    -Tag Smoke `
    -ExcludeTag Slow `
    -Test 'API returns 200'
```

Par défaut, l'applet de commande retourne l'enregistrement d'exécution de test nouvellement créé. Ajoutez `-Wait` pour attendre une exécution terminée ou en échec. `-Timeout` définit la limite d'attente en secondes et a une valeur par défaut de 300. Ajoutez `-IncludeSuite` pour retourner à la fois l'exécution de test et les détails analysés de la suite de tests.

```powershell
$result = Invoke-PSUTest -Path '.\tests\api.tests.ps1' -Wait -IncludeSuite
$result.TestRun
$result.TestSuite
```

Utilisez `-Environment` lorsque les tests nécessitent un environnement d'exécution particulier.

## Planifier des exécutions de tests

Créez des exécutions Pester planifiées à partir de **Run > Tests** en sélectionnant **Create Schedule**. Les tests prennent en charge les planifications simples, continues, cron et ponctuelles. Sélectionnez le chemin de test à exécuter ainsi que les mêmes options d'exécution utilisées pour les autres automatisations planifiées, y compris l'environnement d'exécution, l'identifiant et les paramètres d'ordinateur.

Les chemins de test planifiés sont validés par rapport au dépôt avant leur exécution. Gardez les chemins à l'intérieur du dépôt et assurez-vous que le fichier, le dossier ou le caractère générique référencé correspond à un ou plusieurs fichiers de test.

## Examiner les résultats des tests

Chaque exécution de test enregistre son statut, ses heures de début et de fin, ses totaux, les échecs, les erreurs, les tests ignorés et les détails des erreurs d'exécution. PowerShell Universal écrit la sortie Pester au format XML NUnit et stocke les résultats analysés de la suite et des cas de test afin qu'ils demeurent disponibles après la fin de l'exécution.

Ouvrez une exécution de test à partir de **Run > Tests > Test Results** pour en examiner le résultat global et explorer les suites et les cas individuels. Les exécutions historiques demeurent disponibles pour la comparaison et le dépannage.


---

# 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/tests.md?ask=<question>&goal=<endgoal>
```

`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.