V1

Install.md

@@ -0,0 +1,83 @@
+# 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.