B2-16 PowerShell pour débutants

1. La console, les deux PowerShell et VS Code

PowerShell remplace avantageusement l'invite de commandes (cmd) : ses commandes sont plus régulières, elles renvoient des objets que l'on peut filtrer, trier et exporter, et le même langage sert à taper une commande ou à écrire un script.

Deux versions cohabitent, et il faut savoir laquelle tu utilises. Pour le savoir, tape $PSVersionTable.PSVersion.

1.1 Ouvrir une console

• Utilisateur ou administrateurClic droit sur le menu Démarrer → Terminal (admin) ou Windows PowerShell (admin). Sans élévation, les commandes qui modifient le système (arrêter un service, changer une adresse) sont refusées.
• L'invitePS C:\Users\Administrateur> : PS signifie PowerShell, puis le dossier courant. Tu tapes la commande après le >.
• Les touches utilesTab complète le nom, les flèches ↑ ↓ rappellent les commandes précédentes, Ctrl+C interrompt une commande, cls efface l'écran.
• Le texte rougeC'est une erreur. Lis-la en entier : elle dit presque toujours quelle partie de la commande pose problème.

2. Les cmdlets : Verbe-Nom

Une commande PowerShell s'appelle une cmdlet. Son nom suit une règle simple : un verbe (l'action), un tiret, un nom au singulier (ce sur quoi on agit). Ensuite viennent des paramètres, qui commencent par un tiret.

2.1 Trouver une commande et son mode d'emploi

Personne ne connaît toutes les cmdlets. Trois commandes te donnent l'autonomie :

• Get-CommandCherche une commande par morceau de nom : Get-Command *service* liste toutes les cmdlets qui parlent de services. On peut aussi filtrer par verbe : Get-Command -Verb Stop.
• Get-HelpAffiche le mode d'emploi : Get-Help Get-Service -Examples montre des exemples à copier. -Online ouvre la page web. Update-Help (en administrateur) télécharge l'aide complète.
• Get-MemberMontre ce qu'un résultat contient (propriétés et méthodes) : Get-Service | Get-Member. C'est la clé de la partie 3.
• Les aliasDes raccourcis : ls = Get-ChildItem, ? = Where-Object, % = ForEach-Object. Get-Alias les liste. Pratiques à la main ; dans un script, écris le nom complet pour que tout le monde lise.

3. Des objets, pas du texte

Dans cmd, une commande écrit du texte. En PowerShell, Get-Service renvoie une collection d'objets : un objet par service. Ce que tu vois à l'écran n'est qu'une mise en forme de ces objets.

3.1 Le chemin d'un objet dans le pipeline

Suis ce que devient la commande Get-Service | Where-Object Status -eq Running | Select-Object Name, Status | Export-Csv services.csv.

4. Le pipeline : filtrer, choisir, trier, exporter

Le pipeline relie des cmdlets avec la barre |. Dans une commande suivante, l'objet en cours s'appelle $_ (ou $PSItem) : $_.Status est la propriété Status de l'objet qui passe.

4.1 Les opérateurs de comparaison

PowerShell n'utilise pas =, > ou < pour comparer : ces signes servent à autre chose (affecter une valeur, rediriger vers un fichier). On écrit des opérateurs avec un tiret.

• -eq · -neégal, différent : Status -eq Running. Insensible à la casse.
• -gt · -ge · -lt · -leplus grand, plus grand ou égal, plus petit, plus petit ou égal : CPU -gt 100.
• -like · -match-like accepte les jokers (Name -like "win*") ; -match accepte une expression régulière.
• -and · -or · -notcombinent des conditions : $_.Status -eq "Running" -and $_.StartType -eq "Manual".

4.2 Exporter proprement

• -NoTypeInformationDans Windows PowerShell 5.1, sans ce paramètre, la première ligne du fichier est un commentaire #TYPE … qui gêne le tableur. PowerShell 7 ne l'ajoute plus.
• -Encoding UTF8Garde les accents lisibles (« Spouleur d'impression »). En PowerShell 7, UTF8 n'écrit plus de marque BOM et Excel lit mal les accents : écris -Encoding utf8BOM.
• -Delimiter ";"Excel en français attend le point-virgule comme séparateur de colonnes. Sans lui, tout apparaît dans une seule colonne.
• Format-* en dernierLes cmdlets Format-Table et Format-List produisent du texte pour l'écran. On les met à la fin d'une ligne, jamais avant Export-Csv.

5. Variables, types, tableaux et tables de hachage

Une variable garde une valeur ou des objets pour les réutiliser. Son nom commence par $. On affecte avec =. PowerShell devine le type : texte ([string]), entier ([int]), vrai ou faux ([bool]), date ([datetime]).

5.1 Tableaux et tables de hachage

6. Conditions et boucles

6.1 if et switch

Une condition exécute un bloc entre accolades seulement si le test est vrai. if convient pour deux ou trois cas ; switch compare une valeur à une liste de cas.

6.2 foreach et ForEach-Object

Deux boucles font la même chose avec deux écritures. foreach parcourt une collection déjà stockée dans une variable ; ForEach-Object (alias %) traite les objets au fil du pipeline, en les appelant $_.

7. Travailler avec les fichiers

Un fichier ou un dossier est lui aussi un objet. Quatre cmdlets couvrent l'essentiel :

• Get-ChildItem(alias ls, dir) liste le contenu d'un dossier. -Recurse descend dans les sous-dossiers, -Filter *.log garde un type de fichier. Propriétés utiles : Name, Length (taille en octets), LastWriteTime (dernière modification).
• Get-Contentlit un fichier texte ligne par ligne. -Tail 20 n'affiche que les 20 dernières lignes, pratique pour un journal.
• Set-Content · Add-Contentécrivent dans un fichier : Set-Content remplace le contenu, Add-Content ajoute à la fin.
• Test-Pathrépond True ou False : le chemin existe-t-il ? On l'utilise avant de lire ou de créer.

8. Services et processus

Un service tourne en arrière-plan ; un processus est un programme en cours d'exécution (un service en possède un, mais un programme ouvert par un utilisateur aussi). Les commandes se ressemblent.

• Statusl'état d'un service : Running (en marche) ou Stopped (arrêté).
• StartTypequand il démarre : Automatic, Manual ou Disabled.
• CPU · WorkingSetpour un processus, le temps de processeur consommé (en secondes) et la mémoire utilisée (en octets). Id est son numéro.

9. Le réseau en PowerShell

Trois cmdlets remplacent ipconfig, ping et nslookup avec de vrais objets, donc exportables. Tu les enchaînes du plus proche au plus lointain, comme le dépannage de la fiche B2-02.

10. Écrire un premier script

Un script est un fichier .ps1 qui contient les commandes que tu aurais tapées. Il se crée dans VS Code (ou le Bloc-notes). Le principe : ce qui marche à la main se copie dans un fichier, puis on remplace les valeurs qui changent par des paramètres.

10.1 Un script de diagnostic avec paramètres

Le bloc param( ) doit être la première instruction du script. Chaque paramètre a un type et une valeur par défaut, utilisée quand on n'en donne pas.

# diag-reseau.ps1 : test de la passerelle et du DNS, résultat dans un fichier
param(
    [string]$Passerelle = "172.16.50.254",
    [string]$Nom        = "srv-01.broceliande.lan",
    [string]$Sortie     = "C:\Temp\diag-reseau.txt"
)

$date = Get-Date -Format "dd/MM/yyyy HH:mm"
Set-Content -Path $Sortie -Value "Diagnostic de $env:COMPUTERNAME le $date"

if (Test-Connection $Passerelle -Count 2 -Quiet) { $etat = "OK" } else { $etat = "INJOIGNABLE" }
Add-Content -Path $Sortie -Value "Passerelle $Passerelle : $etat"

$dns = Resolve-DnsName $Nom -Type A -ErrorAction SilentlyContinue
if ($dns) { Add-Content -Path $Sortie -Value "DNS $Nom : $($dns.IPAddress)" }
else      { Add-Content -Path $Sortie -Value "DNS $Nom : ÉCHEC" }

Get-NetIPConfiguration | Out-String | Add-Content -Path $Sortie
Get-Content $Sortie

• # commentaireTout ce qui suit # est ignoré. Commente le pourquoi, pas le quoi.
• param( )Les valeurs que l'utilisateur peut changer. [string] impose un texte, [int] un entier.
• $env:COMPUTERNAMEUne variable d'environnement : le nom de la machine. $env:USERNAME donne l'utilisateur.
• -ErrorAction SilentlyContinueSi Resolve-DnsName échoue, pas de texte rouge : le script teste ensuite le résultat avec if ($dns).

10.2 La stratégie d'exécution

Par sécurité, Windows peut refuser de lancer des scripts. Cette stratégie d'exécution ne bloque que les fichiers de script : taper une commande à la main marche toujours. Les valeurs à connaître :

La stratégie se règle à plusieurs endroits, appelés portées. Quand elles diffèrent, la plus haute dans cette liste l'emporte :

11. Administrer à distance

Se connecter à chaque serveur par le Bureau à distance est lent. WinRM permet d'envoyer des commandes PowerShell à une autre machine depuis la tienne. Deux commandes à connaître :

• Enter-PSSessionouvre une session interactive : l'invite devient [SRV-01]: PS C:\> et tout ce que tu tapes s'exécute sur le serveur. Exit-PSSession pour revenir.
• Invoke-Commandenvoie un bloc de commandes -ScriptBlock { … } à une ou plusieurs machines et récupère le résultat. Idéal pour interroger plusieurs serveurs d'un coup.
• Enable-PSRemotingà lancer sur la machine à administrer, en administrateur : démarre WinRM et ouvre le pare-feu. Windows Server l'a déjà actif ; Windows 11 non.
• -Credentialle compte à utiliser. Get-Credential ouvre une fenêtre qui demande l'identifiant et le mot de passe, sans les écrire dans le script.

11.1 Hors domaine : les machines de confiance

Dans un domaine Active Directory, les machines se reconnaissent par Kerberos et tout marche avec des noms. Entre deux machines d'un groupe de travail (comme au labo), ou en utilisant une adresse IP, le poste administrateur refuse de se connecter à une machine qu'il ne connaît pas. Il faut l'ajouter à la liste TrustedHosts du client.

12. Vérifier et dépanner

12.1 Les erreurs classiques

12.2 Entraîne-toi : les tickets du support

Tu es de permanence au support de Brocéliande Logistique. Six tickets arrivent les uns après les autres : lis le message, observe la sortie, puis choisis la cause.

PS C:\Users\stagiaire> Get-Process | Where-Object { $_.CPU > 100 }
PS C:\Users\stagiaire> dir

    Mode   LastWriteTime   Length Name
    -a---  18/10/2026       0      100

PS C:\Scripts> .\diag-reseau.ps1
.\diag-reseau.ps1 : Impossible de charger le fichier C:\Scripts\diag-reseau.ps1, car
l'exécution de scripts est désactivée sur ce système.

PS C:\Scripts> Get-ExecutionPolicy
Restricted

Get-Service | Format-Table Name, Status | Export-Csv C:\Temp\services.csv

#TYPE Microsoft.PowerShell.Commands.Internal.Format.FormatStartData
"ClassId2e4f51ef21dd47e99d3c952918aff9cd","pageHeaderEntry",...

PS C:\Scripts> dir diag-reseau.ps1
    -a---  18/10/2026   1204   diag-reseau.ps1

PS C:\Scripts> diag-reseau.ps1
diag-reseau.ps1 : Le terme «diag-reseau.ps1» n'est pas reconnu comme nom d'applet de
commande, fonction, fichier de script ou programme exécutable.

PS C:\> Enter-PSSession -ComputerName 172.16.50.10 -Credential Administrateur
Enter-PSSession : Le client WinRM ne peut pas traiter la demande. Si le schéma
d'authentification est différent de Kerberos, ou si l'ordinateur client n'est pas
joint à un domaine, le transport HTTPS doit être utilisé ou l'ordinateur de
destination doit être ajouté au paramètre de configuration TrustedHosts.

PS C:\> $svc = Get-Service -Name Spooler
PS C:\> "Service : $svc.Name"
Service : System.ServiceProcess.ServiceController.Name

13. À l'examen et en entreprise

14. L'essentiel

1. PowerShell travaille avec des objets ; deux versions : Windows PowerShell 5.1 (powershell.exe) et PowerShell 7 (pwsh.exe).
2. Une cmdlet s'écrit Verbe-Nom au singulier, suivie de paramètres commençant par un tiret.
3. Pour s'en sortir seul : Get-Command, Get-Help -Examples, Get-Member.
4. Le pipeline | envoie les objets d'une commande à la suivante ; $_ désigne l'objet en cours.
5. On filtre avec Where-Object, on choisit avec Select-Object, on trie avec Sort-Object, on compte avec Measure-Object.
6. Les comparaisons s'écrivent -eq -ne -gt -lt -like ; jamais = ni >. On exporte avec Export-Csv, et Format-* reste en dernier.
7. Variables en $nom ; tableau @( ) numéroté dès 0 ; table de hachage @{ clé = valeur } ; "$($objet.Propriété)" dans un texte.
8. if, switch, foreach et ForEach-Object : condition entre parenthèses, bloc entre accolades.
9. Un script .ps1 se lance avec .\ ; ses valeurs variables sont des param( ) ; la stratégie d'exécution se règle par portée (-Scope CurrentUser).
10. À distance : Enable-PSRemoting sur la cible, puis Enter-PSSession ou Invoke-Command ; hors domaine, TrustedHosts sur le client.

Les commandes clés

Tout cela tient sur une page : utilise le bouton Mémo à imprimer en haut de la fiche.

15. Quiz noté

16. Exercices : à toi de répondre

Écris ta réponse sous chaque énoncé et envoie-la à ton professeur. Quand il l'a validée, le corrigé s'affiche à la place du cadenas ; s'il te la renvoie « à revoir », lis son commentaire et corrige. Écris les commandes complètes, pas seulement l'idée.

$services = Get-Service
foreach ($s in $services) {
    if ($s.Status = "Stopped") { Write-Host "Arrêté : $s.Name" }
}
$services | Format-Table Name, Status | Export-Csv C:\Temp\arret.csv

17. Au labo : inventaire, diagnostic et commande à distance