Fiche mémo PowerShell

Pwsh sur macOS contre Windows PowerShell 5.1

$PSVersionTable.PSVersionGet-ExecutionPolicy -List

• Contexte : session pwsh.
• Droits : utilisateur courant.
• Effet : lecture de la version et de la politique.
• Vérification : la version s'affiche ; la liste des politiques par portée s'affiche.
• Retour arrière : sans objet.

Découvrir

Conventions

• Nom : Verbe-Nom au singulier (Get-Process, Set-Location). Insensible à la casse.
• Verbes sans effet : Get, Select, Where, Sort, Measure, Test, Format.
• Verbes à effet : Set, New, Add, Rename, Move, Copy, Remove, Stop, Clear, Restart, Invoke.
• Alias (ls, gci, %, ?) pour l'interactif ; noms complets dans un script.

Pipeline d'objets

$_ ou $PSItem : objet courant. Comparaisons : -eq -ne -gt -lt -ge -le -like -match -in -contains -and -or -not (jamais == ni > : > écrit un fichier).

Variables et structures

Fonctions et paramètres

function Get-Exemple {    [CmdletBinding()]    param(        [Parameter(Mandatory)][ValidateNotNullOrEmpty()][string]$Nom,        [ValidateRange(1, 100)][int]$Max = 10,        [ValidateSet("a","b")][string]$Mode = "a"    )    "$Nom $Max $Mode"}

• Contexte : session pwsh.
• Droits : utilisateur courant.
• Effet : déclare la fonction en mémoire, rien d'autre.
• Vérification : Get-Command Get-Exemple la trouve ; Get-Exemple -Nom x affiche « x 10 a ».
• Retour arrière : fermer la session.

Validation : Mandatory, ValidateNotNullOrEmpty, ValidateRange, ValidateSet, ValidateScript, ValidatePattern (liste à confirmer sur la page des paramètres avancés, non relue). Retourner des objets ; Write-Host = affichage seulement.

Erreurs

finally s'exécute toujours (y compris Ctrl+C, d'après la page 7.6). Ne pas masquer avec catch { } vide ou SilentlyContinue partout (peut même étouffer un throw).

Fichiers, CSV, JSON

Valeurs lues d'un CSV : chaînes ([int]$_.Taille). -LiteralPath = pas de jokers. Préciser -Encoding utf8 pour partager avec 5.1 (à vérifier).

-WhatIf, -Confirm, ShouldProcess

Attention, effet notable. Cette commande a un effet notable. Lire le contexte, les droits et l’effet attendu indiqués après le bloc ; ne jamais l’exécuter sur un système réel sans validation, d’abord dans un environnement de test.

Remove-Item -LiteralPath ./essai.csv -WhatIf

• Contexte : dossier de test, fichier synthétique.
• Droits : aucun accès en écriture requis avec -WhatIf.
• Effet : décrit la suppression sans l'effectuer ; sans -WhatIf, la suppression est définitive.
• Vérification : Test-Path ./essai.csv renvoie True.
• Retour arrière : pas de corbeille.

Politique d'exécution

• Fonction de sécurité de type « défense en profondeur », pas une frontière de sécurité (contournable en saisissant le contenu en ligne de commande).
• Appliquée seulement sous Windows ; sur macOS : Unrestricted, non modifiable, comportement Bypass.
• Valeurs Windows : Restricted, AllSigned, RemoteSigned (défaut), Unrestricted, Bypass, Undefined. Portées : Process, CurrentUser, LocalMachine, stratégie de groupe.
• Ne pas copier un conseil « Set-ExecutionPolicy Bypass ».

Modules et PSGallery

Risques : usurpation de nom, compte d'auteur compromis, mise à jour malveillante, dépendances. Contrôler auteur, dépôt source, date, téléchargements. Un module s'exécute avec vos droits. Précautions : bonnes pratiques générales, non issues d'une page officielle lue.

Scripts sûrs

Attention, effet notable. Cette commande a un effet notable. Lire le contexte, les droits et l’effet attendu indiqués après le bloc ; ne jamais l’exécuter sur un système réel sans validation, d’abord dans un environnement de test.

Get-Content -Raw ./script-telecharge.ps1

• Contexte : lire un script non fiable avant tout ; ne jamais enchaîner avec Invoke-Expression.
• Droits : lecture du fichier.
• Effet : lecture seule.
• Vérification : chercher appels réseau, suppressions, Base64.
• Retour arrière : sans objet.

Secrets

• Jamais en clair dans un script, un historique, un journal, une URL.
• SecureString : protection limitée (sous Windows chiffrement en mémoire ; sur macOS à vérifier).
• Get-Credential : saisie interactive, objet PSCredential.
• SecretManagement (1.1.2) et SecretStore (1.0.6) : couche d'abstraction et coffre local chiffré ; modules « feature complete », dépôt archivé, corrections de sécurité seulement (page du 2026-06-22). Évaluer toute extension de coffre tierce.
• Sur le Mac de Stéphane : Trousseau macOS via bin/secret get NOM / bin/avec-secrets de l'Orchestrator.
• Set-Secret, Register-SecretVault modifient la configuration : seulement avec un secret factice, après avis de cyberagent pour un usage réel.

Procédure : lecture seule d'abord

décrire (Get-Command, Get-Help, Get-Member) → lire (Get-*, Test-*) → filtrer à l'écran → -WhatIf → dossier de test → vérifier le résultat → données réelles avec sauvegarde.