# Définition

PowerShell est un langage script fondé sur la programmation orientée objet. Le logiciel PowerShell est l'interpréteur de l’interface en ligne de commande de l'environnement de développement Windows PowerShell.

## Les commandes ou applets de commande (cmdlet)

elles sont composées d’une paire de la forme “verbe ”-“nom” destiné à en faciliter la mémorisation.

exemple :

    get-service

get = verbe

service = nom

## Les variables

Une variable PowerShell est un emplacement de stockage provisoire en mémoire destiné à recueillir une valeur, un objet ou une collection d’objets.
Les variables sont généralement nommées, et leurs noms sont toujours précédés d’un symbole “$“
Les variables sont automatiquement “typées” lors de l’affectation de valeur (si elles ne sont pas déclarées au préalable.)

exemple :

    $variable = une valeur

## Le pipeline

Le pipeline, symbolisée par le caractère “|” (AltGr + 6) permet d'exécuter plusieurs commandes à la suite.

exemple :

    get-process | Sort-Object CPU

Dans ce cas précis, la commande `Sort-Object` tri les processus par utilisation de Cpu

## L' aide

Sous PowerShell la commande `Get-Help` permet d'afficher la fonction et des exemples d'une commande.

    get-help  <la commande>

Mais avant d'utiliser cette commande il faut faire une mise à jour de l'aide de PowerShell avec la commande

     update-help

cette commande permet d'avoir une aide de manière très générale si on souhaite obtenir plus d'information on peut ajouter l'option`-detailed`

    get-help <la commande> -detailed

On peut aussi lister des exemples d'utilisation d'une commande avec l'option `-examples`

    get-help <la commande> -examples

Il arrive parfois que l'aide renvoyée sous PowerShell ne soit pas complète malgré un `Update-Help.`

Pour cela il y a possibilité d'aller consulter directement l'aide en ligne avec l'option`-online`

    get-help <la commande> -online

Si vous voulez de l'aide sur la syntaxe d'une commande, PowerShell indique par “[ ]” si le paramètre est obligatoire.

par exemple si vous voulez de l'aide sur la syntaxe de commande `Get-ChildItem`

    Get-Help Get-ChildItem

on peut constater dans la capture que certains paramètres sont obligatoires.

La commande `Get-Help` permet également de rechercher une commande si, par exemple, vous souhaitez trouver une commande qui gère les services.

    Get-Help service

voici ce que renvoie la commande, on peut voir les commandes qui contiennent le mot service.

Une autre fonction de l'aide permet d'avoir des informations sur un sujet précis.

pour lister ces sujets utilisez l'option`about_*`

    Get-Help about_*

Par exemple, si vous voulez de l'aide au sujet de pipeline

    Get-Help about_pipeline

voici ce que renvoie la commande

## Les providers

Dans PowerShell, les providers permettent d'accéder par exemple à la base de registre, aux fichiers système à l'environnement etc…

- Base de Registre {HKLM, HKCU}
- Alias {alias}
- Environnement {env}
- FileSystem {C,D,E,F}
- Function {Function}
- variable {Variable}

pour lister l'ensemble des providers, on utilise la commande

    Get-psdrive

L'avantage c'est que vous pouvez parcourir ces éléments comme si c'était un système de fichiers.

Exemple, si vous voulez parcourir la base de registre machine il suffit de taper `cd hklm :` et vous vous retrouvez dans la base de registre et la parcourir comme si c'était un filesystem et revenir dans votre arborescence Windows avec un `cd c:`.

Vous avez ensuite la possibilité de créer ou de consulter des entrées dans la base de registre comme si c'était un filesystem et utiliser les commandes de base

exemple avec la commande `Get-ChildItem` ,vous pouvez consulter toute la base de registre de votre hkey local machine

# Création d'un menu sous Powershell

Voici un exemple de menu qu'il est possible de faire avec la méthode suivante :

## Principe de fonctionnement

Nous avons besoin de déclarer une variable qui va servir en quelque sorte de bouton “allumé” ou “éteins” : `$continue = $true`

Avec cette variable j'utilise une boucle pour permettre de laisser en permanence l'affichage :

    while (true){
    	<le menu avec des write-host>
    }

Puis une seconde variable pour stocker mon choix avec `$choix = read-host “faire un choix”`

Suivant l'état de ce choix le script sortira de la boucle `while` et cela provoquera soit une action du script soit une sortie du script avec `switch ($choix)`.

Le `switch` va permettre d'indexer les choix ,de les lister et d'exécuter les commandes.

Pour sortir du script si vous faites le choix ‘x’ le script passe la variable `$continue` à `false` ce qui aura pour effet d'arrêter la boucle`while`.

La commande `default` permet de renvoyer un message d'avertissement si vous rentrez un choix qui n'est pas dans le menu.

## Exemple

    $continue = $true
    while ($continue){
    	write-host “----------------------MON TITRE -----------------------”
    	write-host “1. mon action 1”
    	write-host "2. mon action 2"
    	write-host "x. exit"
    	write-host"-------------------------------------------------------------------"
    	$choix = read-host “faire un choix :”
    	switch ($choix){
    		1{commande de mon action 1}
    		2{commande de mon action 2}
    		‘x’ {$continue = $false}
    		default {Write-Host "Choix invalide"-ForegroundColor Red}
    	}
    }