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

# Démarrage

Commencez avec PowerShell Universal en installant le serveur, en vous connectant, puis en créant votre premier terminal d'API, script et appli.

## Installer PowerShell Universal

Vous devrez installer le serveur PowerShell Universal. [Il existe plusieurs façons de le faire,](/powershell-universal/fr/getting-started.md) mais vous pouvez utiliser la ligne de commande ci-dessous pour commencer rapidement :

{% tabs %}
{% tab title="Windows" %}
Vous pouvez installer PowerShell Universal comme service. Assurez-vous que PowerShell est exécuté en tant qu'administrateur, sinon le service ne s'installera pas correctement.

{% code collapsedlinecount="10" %}

```powershell
Install-Module Devolutions.PowerShellUniversal
Install-PSUServer
```

{% endcode %}
{% endtab %}

{% tab title="Linux" %}
Vous pouvez installer PowerShell Universal à l'aide du script shell suivant :

{% code collapsedlinecount="10" %}

```powershell
Install-Module Devolutions.PowerShellUniversal
Install-PSUServer
```

{% endcode %}
{% endtab %}

{% tab title="Mac OS X" %}
Vous pouvez installer PowerShell Universal à l'aide du module PowerShell Universal :

{% code collapsedlinecount="10" %}

```powershell
Install-Module Devolutions.PowerShellUniversal
Install-PSUServer -AddToPath
Start-PSUServer -Port 5000
```

{% endcode %}
{% endtab %}

{% tab title="Raspberry PI OS" %}
{% code collapsedlinecount="10" %}

```
wget https://cdn.devolutions.net/download/Devolutions.PowerShellUniversal.linux-arm.2026.3.0.0.zip
unzip Devolutions.PowerShellUniversal.linux-arm.2026.3.0.0.zip -d ./PSU
chmod +x ./PSU/Universal.Server
./PSU/Universal.Server

```

{% endcode %}
{% endtab %}
{% endtabs %}

## Ouvrir PowerShell Universal

Par défaut, PowerShell Universal s'exécute sur le port 5000 de localhost. Ouvrez un navigateur web et accédez à `http://localhost:5000`.

### Se connecter avec un Devolutions Account

La première fois que vous accédez à PowerShell Universal, vous pouvez vous connecter avec un [Devolutions Account](https://docs.devolutions.net/portal/fr/profile/create-your-devolutions-account) afin de recevoir une licence de développeur gratuite. Cette licence activera toutes les fonctionnalités et est destinée aux flux de travail hors production.

Ce processus de licence de développeur est destiné au développement local et nécessite un accès local à l'hôte PowerShell Universal. Si les utilisateurs accèdent à PSU uniquement à partir de navigateurs distants via Docker, IIS ou un proxy inverse, ils doivent plutôt utiliser l'un des parcours de licence standard.

### Assistant de première exécution

Vous pouvez aussi choisir d'exécuter la configuration de l'assistant de première exécution au lieu de vous connecter avec un Devolutions Account, puis fournir une clé de licence.

## Créer une API

Les API vous permettent d'appeler des scripts PowerShell via HTTP. Naviguez vers Build > APIs > Endpoints et sélectionnez Create Endpoint. Spécifiez une URL, désactivez l'authentification, puis sélectionnez Save.

Sélectionnez le nouveau terminal pour ouvrir son éditeur, puis saisissez la commande suivante :

{% code collapsedlinecount="10" %}

```powershell
Get-ComputerInfo
```

{% endcode %}

Enregistrez le script, puis cliquez sur le bouton Execute pour le tester.

Vous pouvez également exécuter l'API via `Invoke-RestMethod`.

{% code collapsedlinecount="10" %}

```powershell
PS C:\Users\adamr> Invoke-RestMethod http://localhost:5000/hello-world

WindowsBuildLabEx                                       : 22000.1.amd64fre.co_release.210604-1628
WindowsCurrentVersion                                   : 6.3
WindowsEditionId                                        : Professional
WindowsInstallationType                                 : Client
WindowsInstallDateFromRegistry                          : 8/6/2021 4:05:12 PM
WindowsProductId                                        : 00330-52452-93139-AAOEM
WindowsProductName                                      : Windows 10 Pro
WindowsRegisteredOrganization                           :
```

{% endcode %}

## Créer un script

Pour créer un script, naviguez vers Build > Scripts et sélectionnez Create Script. Saisissez un nom et sélectionnez Save. PowerShell Universal ouvre l'éditeur de script.

Saisissez le script suivant dans l'éditeur et enregistrez :

{% code collapsedlinecount="10" %}

```powershell
Read-Host "What should I say?"

1..100 | ForEach-Object {
    Write-Progress -PercentComplete $_ -Activity "Processing..."
}

Get-Service
```

{% endcode %}

Une fois le script enregistré, cliquez sur Run.

## Créer une appli

Pour créer une nouvelle interface utilisateur basée sur PowerShell, naviguez vers Build > Apps et sélectionnez Create App. Saisissez un nom et une URL pour l'appli.

Sélectionnez Save, puis sélectionnez le nom de l'appli pour ouvrir son éditeur. Remplacez le script généré par ce qui suit :

{% code collapsedlinecount="10" %}

```powershell
New-UDApp -Title "Hello, World!" -Content {
    New-UDButton -Text "Click Me" -OnClick {
        Show-UDToast -Message 'Success!!'
    }
}
```

{% endcode %}

Enregistrez l'appli, sélectionnez Restart, puis sélectionnez View App. Dans l'appli, sélectionnez Click Me.

En savoir plus sur les diverses fonctionnalités de PowerShell Universal :

* [API](/powershell-universal/fr/api/about.md)
* [Automatisation](/powershell-universal/fr/automatisation/about.md)
* [Applis](/powershell-universal/fr/applis/building-dashboards.md)

### Voir aussi

* [Devolutions Academy – Installation](https://academy.devolutions.net/student/activity/3465938-installation)


---

# 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/get-started.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.
