# Installation de wsl-manage

## 1. Placer les fichiers

Conservez les fichiers suivants dans un dossier permanent, par exemple :

```text
E:\Drive\Apps\WSL\
|-- wsl-manage.cmd
|-- wsl-manage-core.ps1
|-- README.md
`-- Install.md
```

Ne placez pas ce dossier dans un emplacement temporaire.

## 2. Ajouter le dossier au PATH

Ouvrez PowerShell et executez :

```powershell
$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
$installPath = 'E:\Drive\Apps\WSL'

if (($userPath -split ';') -notcontains $installPath) {
    [Environment]::SetEnvironmentVariable(
        'Path',
        (($userPath.TrimEnd(';') + ';' + $installPath).Trim(';')),
        'User'
    )
}
```

Fermez puis ouvrez un nouveau terminal PowerShell pour que le changement soit
pris en compte.

## 3. Verifier l'installation

Executez :

```powershell
Get-Command wsl-manage
```

La commande doit pointer vers :

```text
E:\Drive\Apps\WSL\wsl-manage.cmd
```

Affichez ensuite l'aide :

```powershell
wsl-manage -?
```

## 4. Utiliser le script

Sauvegarde par defaut :

```powershell
wsl-manage
```

Restauration :

```powershell
wsl-manage restore
```

## Depannage

Si PowerShell tente de charger directement un fichier `.ps1`, verifiez que le
fichier public s'appelle bien `wsl-manage.cmd` et que seul le dossier
d'installation est present dans le `PATH`.

Le lanceur utilise `-ExecutionPolicy Bypass` uniquement pour cette execution.
Il n'est normalement pas necessaire de modifier la politique d'execution
PowerShell du systeme.

L'execution en administrateur n'est pas requise pour une sauvegarde standard.
Elle peut etre necessaire pour acceder a certains fichiers VHDX ou les
compacter.