Aide-mémoire PowerShell

Liste les fichiers et répertoires. Alias ls, gci, dir. -Recurse parcourt tout, -Force inclut les cachés.

Get-ChildItem
Get-ChildItem -Recurse -Filter *.ts
Get-ChildItem -Force
gci -Directory

Change le répertoire courant. Alias cd. Supporte - pour le précédent et ~ pour le home.

Set-Location s:\MaisTools
cd ~
cd ..

Affiche le chemin actuel. Alias pwd.

Get-Location
pwd

Vérifie si un chemin existe. Retourne $true ou $false.

Test-Path .\file.txt
Test-Path .\src -PathType Container
if (Test-Path .\dir) { 'existe' }

Sauvegarde le répertoire courant dans une pile (Push) et y revient (Pop). Utile dans les scripts.

Push-Location C:\Temp
# ...trabalho aqui...
Pop-Location

Résout un chemin relatif en absolu, ou l'inverse avec -Relative.

Resolve-Path .\src
Resolve-Path -Relative C:\Temp\file.txt

Crée des fichiers, répertoires ou liens symboliques. -ItemType définit le type. -Force sur un fichier existant le tronque.

New-Item -ItemType File novo.txt
New-Item -ItemType Directory -Force pasta\sub
New-Item -ItemType SymbolicLink -Path link -Target target

Copie des fichiers ou répertoires. -Recurse pour les arborescences, -Force écrase la destination.

Copy-Item a.txt b.txt
Copy-Item -Recurse src\ dest\
Copy-Item *.log -Destination archive\

Déplace ou renomme des fichiers et répertoires.

Move-Item old.txt new.txt
Move-Item *.log archive\

Supprime des fichiers ou répertoires. -Recurse -Force supprime sans confirmation (dangereux).

Remove-Item file.txt
Remove-Item -Recurse -Force node_modules
Remove-Item *.tmp

Renomme des fichiers. Accepte un ScriptBlock dans -NewName pour le renommage en masse.

Rename-Item old.txt new.txt
Get-ChildItem *.txt | Rename-Item -NewName { $_.Name -replace '\.txt$','.md' }

Obtient les infos d'un élément (Length, LastWriteTime, etc.). Ne lit pas le contenu, seulement les métadonnées.

Get-Item .\file.txt
(Get-Item file.txt).Length
Get-Item file.txt | Select-Object Name, Length, LastWriteTime

Lit le contenu d'un fichier. -TotalCount comme head, -Tail comme tail, -Wait suit comme tail -f.

Get-Content file.txt
Get-Content file.txt -TotalCount 10
Get-Content file.txt -Tail 20
Get-Content app.log -Wait -Tail 100

Écrit du contenu dans un fichier, en l'écrasant. -Encoding utf8 évite le défaut UTF-16 avec BOM en PS 5.1.

Set-Content out.txt 'linha'
'a','b','c' | Set-Content lista.txt -Encoding utf8

Ajoute du contenu à un fichier existant. Équivalent à >> en bash.

Add-Content log.txt 'nova entrada'
Get-Date | Add-Content log.txt

Redirige la sortie vers un fichier. -Append ajoute, -Encoding contrôle l'encodage.

Get-Process | Out-File processes.txt
Get-Service | Out-File -Append -Encoding utf8 services.log

Vide le contenu d'un fichier sans le supprimer.

Clear-Content log.txt
Clear-Content *.tmp

Filtre les objets du pipeline par condition. Alias ? et where. Supporte la syntaxe abrégée Propriété -op Valeur.

Get-Process | Where-Object { $_.CPU -gt 10 }
Get-Service | Where-Object Status -eq Running
gci | ? { $_.Length -gt 1MB }

Trie les objets par propriété. -Descending inverse, -Unique supprime les doublons.

Get-Process | Sort-Object CPU -Descending
Get-ChildItem | Sort-Object Length -Descending
'b','a','c' | Sort-Object

Sélectionne N objets du pipeline ou des propriétés de chaque objet. -ExpandProperty extrait la valeur.

Get-Process | Select-Object -First 5
Get-Process | Select-Object Name, CPU, WS
Get-Service | Select-Object -ExpandProperty Name

Itère sur le pipeline en appliquant un bloc à chaque objet. Alias % et foreach. -Parallel en parallèle (PS 7+).

Get-ChildItem | ForEach-Object { $_.Name.ToUpper() }
1..5 | %{ $_ * 2 }
$urls | ForEach-Object -Parallel { Invoke-WebRequest $_ }

Compte, somme, moyenne, max ou min d'une collection. -Line, -Word, -Character pour le texte.

Get-Process | Measure-Object -Property WS -Sum -Average
Get-Content file.txt | Measure-Object -Line
Get-ChildItem | Measure-Object

Regroupe les objets par propriété. Utile pour compter les occurrences ou créer des dictionnaires avec -AsHashTable.

Get-Process | Group-Object ProcessName
Get-ChildItem | Group-Object Extension -NoElement

Recherche des motifs dans des chaînes ou fichiers. Équivalent de grep. -Pattern accepte regex, -SimpleMatch le désactive.

Select-String 'TODO' *.ts
Select-String -Path src\*.ts -Pattern 'error' -CaseSensitive
Get-ChildItem -Recurse | Select-String 'API_KEY'

Affiche les cmdlets disponibles avec filtres par nom, module ou type. (Get-Command npm).Source donne le chemin.

Get-Command npm
Get-Command *process*
(Get-Command npm).Source
Get-Command -Module Microsoft.PowerShell.Utility

Affiche les propriétés et méthodes d'un objet. Indispensable pour découvrir ce qu'on peut faire avec un type.

Get-Process | Get-Member
(Get-Date) | Get-Member -MemberType Method
'abc' | Get-Member

Affiche l'aide des cmdlets ou des sujets about_*. -Examples montre des exemples, -Online ouvre la version web.

Get-Help Get-ChildItem
Get-Help Get-Process -Examples
Get-Help about_Variables
Get-Help Set-Content -Online

Les variables commencent par $ et ne nécessitent pas de déclaration. Supportent arrays (@()) et hashtables (@{}).

$nome = 'Bruno'
$idade = 30
$lista = @(1, 2, 3)
$hash = @{ a = 1; b = 2 }

Lit et définit les variables d'environnement. Get-ChildItem env: les liste toutes. Modification valable uniquement pour la session.

$env:PATH
$env:USERPROFILE
$env:DEBUG = 'true'
Get-ChildItem env:

Valeur nulle. Dans les comparaisons placez $null à gauche ($null -eq $x) pour éviter les surprises avec les arrays.

if ($null -eq $var) { 'vazio' }
$lista = @($null, 1, 2)
[string]::IsNullOrEmpty($x)

Conversion de types avec [type]. Fonctionne pour int, string, datetime, arrays typés, regex.

[int]'42'
[datetime]'2026-01-15'
[int[]]$nums = 1,2,3
[regex]::Escape($pattern)

Définit la portée d'une variable : global (toute la session), script (ce fichier) ou local (cette fonction).

$global:config = @{}
$script:contador = 0
function f { $local:tmp = 1 }

Les guillemets doubles étendent $var et $(expr). Les guillemets simples sont littéraux et n'étendent rien.

$nome = "Bruno"
"Olá $nome"
"Caminho: $($obj.Property)"
'literal $nome'  # sem expansão

Chaînes multiligne (here-strings). @"..."@ étend les variables, @'...'@ est littéral. La fermeture doit être en colonne 0.

@"
linha 1 com $nome
linha 2
"@

@'
literal $nome
'@

Opérateur de formatage style printf. Supporte nombres, dates et alignement ({0,5:N2}).

'{0} tem {1} anos' -f $nome, $idade
'{0:N2}' -f 1234.5678  # 1,234.57
'{0:yyyy-MM-dd}' -f (Get-Date)

Opérations sur chaînes : -replace utilise regex, -split sépare en array, -join concatène un array en chaîne.

'abc123' -replace '\d', 'X'
'a,b,c' -split ','
@('a','b','c') -join ', '

Structure conditionnelle. Utilise les opérateurs PowerShell (-eq, -lt) au lieu de == ou <.

if (Test-Path .\file) {
  'existe'
} elseif ($x -gt 0) {
  'positivo'
} else {
  'outro'
}

Alternative au if enchaîné. -Regex et -Wildcard activent les motifs, -File lit des lignes depuis un fichier.

switch ($x) {
  1 { 'um' }
  2 { 'dois' }
  default { 'outro' }
}

switch -Regex ($texto) {
  '^\d+$' { 'número' }
}

Boucles sur collections (foreach), avec compteur (for), tant que condition (while), ou au moins une fois (do/while).

foreach ($f in Get-ChildItem) { $f.Name }
for ($i = 0; $i -lt 5; $i++) { $i }
while ($cond) { ... }
do { ... } while ($cond)

Capture d'erreurs. Pour attraper les erreurs non terminantes utilisez -ErrorAction Stop sur le cmdlet.

try {
  Cmdlet -ErrorAction Stop
} catch [System.IO.IOException] {
  Write-Error "IO: $_"
} catch {
  Write-Error $_
} finally {
  Cleanup
}

break sort de la boucle, continue passe à l'itération suivante, return sort de la fonction.

foreach ($x in 1..10) {
  if ($x -eq 5) { break }
  if ($x % 2 -eq 0) { continue }
  $x
}

Opérateurs de comparaison. Pas de == en PowerShell, utilisez toujours -eq, -ne, -lt, -gt, -le, -ge.

$x -eq 5     # igual
$x -ne 5     # diferente
$x -lt 10    # menor
$x -gt 0     # maior
$x -le 10    # menor ou igual
$x -ge 0     # maior ou igual

Autres opérateurs : -like utilise des wildcards, -match du regex, -contains teste l'appartenance, -in est l'inverse.

'file.txt' -like '*.txt'         # wildcards
'abc123' -match '\d+'             # regex
@(1,2,3) -contains 2              # pertença
2 -in @(1,2,3)                   # pertença (invertido)

Opérateurs logiques. -and, -or, -not, -xor. ! est un alias de -not.

($x -gt 0) -and ($x -lt 10)
($a -eq 1) -or ($b -eq 2)
-not (Test-Path .\file)
!$cond

Liste les processus avec propriétés (CPU, WS, Id, ProcessName). Sans argument, liste tout.

Get-Process
Get-Process node, chrome
Get-Process -Id 1234

Arrête les processus par nom ou Id. -Force évite la confirmation. Peut recevoir des objets du pipeline.

Stop-Process -Name node
Stop-Process -Id 1234 -Force
Get-Process node | Stop-Process

Démarre un programme. -Wait bloque jusqu'à la fin, -NoNewWindow exécute dans la console actuelle, -Verb RunAs élève.

Start-Process notepad
Start-Process npm -ArgumentList 'run','dev'
Start-Process pwsh -Verb RunAs

Attend la fin d'un processus. -Timeout abandonne après N secondes.

Wait-Process -Name node
Wait-Process -Id 1234 -Timeout 30

Exécute une commande ou un script. Nécessaire quand le chemin contient des espaces ou pour appeler dynamiquement.

& 'C:\Program Files\App\app.exe' arg1 arg2
& $cmd
& { Get-Process; Get-Service }

Convertit du JSON en objets PowerShell. -AsHashtable retourne une hashtable (PS 6+) au lieu de PSCustomObject.

Get-Content pkg.json | ConvertFrom-Json
'{"a":1}' | ConvertFrom-Json
$obj.dependencies

Convertit des objets PowerShell en JSON. -Depth contrôle la profondeur (défaut 2, souvent trop bas).

$obj | ConvertTo-Json -Depth 10
@{a=1; b=2} | ConvertTo-Json -Compress
Get-Process | Select-Object Name,Id | ConvertTo-Json

Lit un CSV en objets avec propriétés. -Delimiter pour ; ou autres, -Header si le fichier n'a pas d'en-tête.

Import-Csv users.csv
Import-Csv data.csv -Delimiter ';' -Encoding utf8

Exporte des objets en CSV. -NoTypeInformation supprime la ligne de type en haut (défaut en PS 6+).

Get-Process | Export-Csv processes.csv -NoTypeInformation
$data | Export-Csv out.csv -Encoding utf8 -Delimiter ';'

Client HTTP complet. Retourne la réponse comme objet avec .Content, .StatusCode, .Headers. Alias iwr.

Invoke-WebRequest https://example.com
iwr https://api.example.com -OutFile data.json
iwr -Uri $url -Method POST -Body $body

Client HTTP qui parse automatiquement JSON ou XML en objets. Le plus utilisé pour les API REST. Alias irm.

Invoke-RestMethod https://api.github.com/users/octocat
irm $url -Method POST -Body ($obj | ConvertTo-Json) -ContentType 'application/json'

Teste la connectivité TCP à un hôte et port. Windows uniquement. Sur Linux/macOS utilisez Test-Connection -TcpPort (PS 7+).

Test-NetConnection google.com -Port 443
Test-NetConnection -ComputerName 8.8.8.8 -TraceRoute

Équivalent à ping. -Count limite les paquets, -Quiet ne retourne que $true ou $false.

Test-Connection google.com -Count 4
Test-Connection 8.8.8.8 -Quiet  # bool

Liste les modules. -ListAvailable montre tout ce qui est installé, pas seulement ce qui est chargé.

Get-Module
Get-Module -ListAvailable
Get-Module -Name Pester

Charge un module dans la session actuelle. -Force le recharge s'il est déjà importé.

Import-Module Pester
Import-Module .\MeuModulo.psm1 -Force

Installe des modules depuis la PowerShell Gallery. -Scope CurrentUser évite les permissions admin.

Install-Module Pester -Scope CurrentUser
Install-Module Az -Force -AllowClobber

Recherche des modules disponibles sur la PowerShell Gallery.

Find-Module Az*
Find-Module -Tag azure

Exécute du code en arrière-plan. Receive-Job récupère les résultats, -Wait bloque jusqu'à la fin.

$j = Start-Job { Get-Process }
Receive-Job $j -Wait -AutoRemoveJob
Get-Job | Remove-Job

Jobs background légers basés sur des threads (plus rapides que Start-Job). Inclus en PS 7+, en 5.1 installez avec Install-Module ThreadJob.

$j = Start-ThreadJob { 1..10 | %{ $_ * 2 } }
$urls | ForEach-Object -Parallel { iwr $_ } -ThrottleLimit 5

Mesure le temps d'exécution d'un bloc. Retourne un TimeSpan avec TotalSeconds, TotalMilliseconds, etc.

Measure-Command { Get-ChildItem -Recurse }
(Measure-Command { ./script.ps1 }).TotalSeconds

Exécute des commandes sur une machine distante via WinRM. Supporte les sessions persistantes avec -Session.

Invoke-Command -ComputerName server01 -ScriptBlock { Get-Service }
Invoke-Command -Session $s -ScriptBlock { hostname }

Met l'exécution en pause pendant N secondes ou millisecondes.

Start-Sleep -Seconds 5
Start-Sleep -Milliseconds 250