PowerShell Cheat Sheet
Cmdlets, pipeline de objectos e one-liners
Navegação
Lista ficheiros e directórios. Alias ls, gci, dir. -Recurse percorre tudo, -Force inclui ocultos.
Get-ChildItem Get-ChildItem -Recurse -Filter *.ts Get-ChildItem -Force gci -Directory
Muda o directório actual. Alias cd. Suporta - para o anterior e ~ para a home.
Set-Location s:\MaisTools cd ~ cd ..
Mostra o caminho actual. Alias pwd.
Get-Location pwd
Verifica se um caminho existe. Devolve $true ou $false.
Test-Path .\file.txt
Test-Path .\src -PathType Container
if (Test-Path .\dir) { 'existe' }Guarda o directório actual numa stack (Push) e regressa depois (Pop). Útil em scripts.
Push-Location C:\Temp # ...trabalho aqui... Pop-Location
Resolve um caminho relativo para absoluto, ou faz o inverso com -Relative.
Resolve-Path .\src Resolve-Path -Relative C:\Temp\file.txt
Ficheiros
Cria ficheiros, directórios ou symlinks. -ItemType define o tipo. -Force em ficheiro existente trunca o conteúdo.
New-Item -ItemType File novo.txt New-Item -ItemType Directory -Force pasta\sub New-Item -ItemType SymbolicLink -Path link -Target target
Copia ficheiros ou directórios. -Recurse para árvores, -Force sobrescreve o destino.
Copy-Item a.txt b.txt Copy-Item -Recurse src\ dest\ Copy-Item *.log -Destination archive\
Move ou renomeia ficheiros e directórios.
Move-Item old.txt new.txt Move-Item *.log archive\
Apaga ficheiros ou directórios. -Recurse -Force apaga tudo sem confirmar (perigoso).
Remove-Item file.txt Remove-Item -Recurse -Force node_modules Remove-Item *.tmp
Renomeia ficheiros. Aceita ScriptBlock no -NewName para renomear em massa.
Rename-Item old.txt new.txt
Get-ChildItem *.txt | Rename-Item -NewName { $_.Name -replace '\.txt$','.md' }Obtém informação de um item (Length, LastWriteTime, etc). Não lê conteúdo, só metadados.
Get-Item .\file.txt (Get-Item file.txt).Length Get-Item file.txt | Select-Object Name, Length, LastWriteTime
Conteúdo
Lê o conteúdo de um ficheiro. -TotalCount como head, -Tail como tail, -Wait segue como 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
Escreve conteúdo num ficheiro, sobrescrevendo. -Encoding utf8 evita o default UTF-16 com BOM no PS 5.1.
Set-Content out.txt 'linha' 'a','b','c' | Set-Content lista.txt -Encoding utf8
Acrescenta conteúdo a um ficheiro existente. Equivalente a >> em bash.
Add-Content log.txt 'nova entrada' Get-Date | Add-Content log.txt
Redireciona output para um ficheiro. -Append acrescenta, -Encoding controla a codificação.
Get-Process | Out-File processes.txt Get-Service | Out-File -Append -Encoding utf8 services.log
Esvazia o conteúdo de um ficheiro sem o apagar.
Clear-Content log.txt Clear-Content *.tmp
Pipeline
Filtra objectos no pipeline por uma condição. Alias ? e where. Suporta sintaxe abreviada Propriedade -op Valor.
Get-Process | Where-Object { $_.CPU -gt 10 }
Get-Service | Where-Object Status -eq Running
gci | ? { $_.Length -gt 1MB }Ordena objectos por propriedade. -Descending inverte, -Unique remove duplicados.
Get-Process | Sort-Object CPU -Descending Get-ChildItem | Sort-Object Length -Descending 'b','a','c' | Sort-Object
Selecciona N objectos do pipeline ou propriedades de cada objecto. -ExpandProperty extrai o valor.
Get-Process | Select-Object -First 5 Get-Process | Select-Object Name, CPU, WS Get-Service | Select-Object -ExpandProperty Name
Itera o pipeline aplicando um bloco a cada objecto. Alias % e foreach. -Parallel corre em paralelo (PS 7+).
Get-ChildItem | ForEach-Object { $_.Name.ToUpper() }
1..5 | %{ $_ * 2 }
$urls | ForEach-Object -Parallel { Invoke-WebRequest $_ }Conta, soma, calcula média, máximo ou mínimo de uma colecção. -Line, -Word, -Character para texto.
Get-Process | Measure-Object -Property WS -Sum -Average Get-Content file.txt | Measure-Object -Line Get-ChildItem | Measure-Object
Agrupa objectos por propriedade. Útil para contar ocorrências ou construir dicionários com -AsHashTable.
Get-Process | Group-Object ProcessName Get-ChildItem | Group-Object Extension -NoElement
Pesquisa
Procura padrões em strings ou ficheiros. Equivalente a grep. -Pattern aceita regex, -SimpleMatch desliga regex.
Select-String 'TODO' *.ts Select-String -Path src\*.ts -Pattern 'error' -CaseSensitive Get-ChildItem -Recurse | Select-String 'API_KEY'
Mostra cmdlets disponíveis com filtros por nome, módulo ou tipo. (Get-Command npm).Source devolve o caminho.
Get-Command npm Get-Command *process* (Get-Command npm).Source Get-Command -Module Microsoft.PowerShell.Utility
Mostra propriedades e métodos de um objecto. Indispensável para descobrir o que se pode fazer com um tipo.
Get-Process | Get-Member (Get-Date) | Get-Member -MemberType Method 'abc' | Get-Member
Mostra ajuda de cmdlets ou tópicos about_*. -Examples mostra exemplos, -Online abre a versão web.
Get-Help Get-ChildItem Get-Help Get-Process -Examples Get-Help about_Variables Get-Help Set-Content -Online
Variáveis
Variáveis começam por $ e não precisam de declaração. Suportam arrays (@()) e hashtables (@{}).
$nome = 'Bruno'
$idade = 30
$lista = @(1, 2, 3)
$hash = @{ a = 1; b = 2 }Acede e define variáveis de ambiente. Get-ChildItem env: lista todas. Alteração vale só na sessão actual.
$env:PATH $env:USERPROFILE $env:DEBUG = 'true' Get-ChildItem env:
Valor nulo. Em comparações coloca $null à esquerda ($null -eq $x) para evitar surpresas com arrays.
if ($null -eq $var) { 'vazio' }
$lista = @($null, 1, 2)
[string]::IsNullOrEmpty($x)Conversão de tipos com [tipo]. Funciona para int, string, datetime, arrays tipados, regex.
[int]'42' [datetime]'2026-01-15' [int[]]$nums = 1,2,3 [regex]::Escape($pattern)
Define o âmbito de uma variável: global (toda a sessão), script (só este ficheiro) ou local (esta função).
$global:config = @{}
$script:contador = 0
function f { $local:tmp = 1 }Strings
Aspas duplas expandem $var e $(expr). Aspas simples são literais e não expandem nada.
$nome = "Bruno" "Olá $nome" "Caminho: $($obj.Property)" 'literal $nome' # sem expansão
Strings multilinha (here-strings). @"..."@ expande variáveis, @'...'@ é literal. O fecho tem de estar na coluna 0.
@" linha 1 com $nome linha 2 "@ @' literal $nome '@
Operador de formatação tipo printf. Suporta números, datas e alinhamento ({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)Operações sobre strings: -replace usa regex, -split separa em array, -join junta um array numa string.
'abc123' -replace '\d', 'X'
'a,b,c' -split ','
@('a','b','c') -join ', 'Controlo
Estrutura condicional. Usa operadores PowerShell (-eq, -lt) em vez de == ou <.
if (Test-Path .\file) {
'existe'
} elseif ($x -gt 0) {
'positivo'
} else {
'outro'
}Alternativa ao if encadeado. -Regex e -Wildcard activam padrões, -File lê linhas de um ficheiro.
switch ($x) {
1 { 'um' }
2 { 'dois' }
default { 'outro' }
}
switch -Regex ($texto) {
'^\d+$' { 'número' }
}Loops sobre colecções (foreach), com contador (for), enquanto condição (while), ou pelo menos uma vez (do/while).
foreach ($f in Get-ChildItem) { $f.Name }
for ($i = 0; $i -lt 5; $i++) { $i }
while ($cond) { ... }
do { ... } while ($cond)Captura de erros. Para apanhar erros não terminantes usa -ErrorAction Stop no cmdlet.
try {
Cmdlet -ErrorAction Stop
} catch [System.IO.IOException] {
Write-Error "IO: $_"
} catch {
Write-Error $_
} finally {
Cleanup
}break sai do loop, continue salta para a iteração seguinte, return sai da função.
foreach ($x in 1..10) {
if ($x -eq 5) { break }
if ($x % 2 -eq 0) { continue }
$x
}Operadores
Operadores de comparação. Não existe == em PowerShell, usa sempre -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
Outros operadores: -like usa wildcards, -match usa regex, -contains testa pertença num array, -in é o inverso.
'file.txt' -like '*.txt' # wildcards 'abc123' -match '\d+' # regex @(1,2,3) -contains 2 # pertença 2 -in @(1,2,3) # pertença (invertido)
Operadores lógicos. -and, -or, -not, -xor. ! é alias de -not.
($x -gt 0) -and ($x -lt 10) ($a -eq 1) -or ($b -eq 2) -not (Test-Path .\file) !$cond
Processos
Lista processos com propriedades (CPU, WS, Id, ProcessName). Sem argumentos lista todos.
Get-Process Get-Process node, chrome Get-Process -Id 1234
Termina processos por nome ou Id. -Force evita confirmação. Pode receber objectos pelo pipeline.
Stop-Process -Name node Stop-Process -Id 1234 -Force Get-Process node | Stop-Process
Inicia um programa. -Wait bloqueia até terminar, -NoNewWindow corre na consola actual, -Verb RunAs eleva.
Start-Process notepad Start-Process npm -ArgumentList 'run','dev' Start-Process pwsh -Verb RunAs
Espera que um processo termine. -Timeout aborta após N segundos.
Wait-Process -Name node Wait-Process -Id 1234 -Timeout 30
Executa um comando ou script. Necessário quando o caminho tem espaços ou para chamar executáveis dinamicamente.
& 'C:\Program Files\App\app.exe' arg1 arg2
& $cmd
& { Get-Process; Get-Service }Dados
Converte JSON em objectos PowerShell. -AsHashtable devolve hashtable (PS 6+) em vez de PSCustomObject.
Get-Content pkg.json | ConvertFrom-Json
'{"a":1}' | ConvertFrom-Json
$obj.dependenciesConverte objectos PowerShell em JSON. -Depth controla a profundidade (default 2, geralmente baixo demais).
$obj | ConvertTo-Json -Depth 10
@{a=1; b=2} | ConvertTo-Json -Compress
Get-Process | Select-Object Name,Id | ConvertTo-JsonLê um CSV para objectos com propriedades. -Delimiter para ; ou outros, -Header se o ficheiro não tiver cabeçalho.
Import-Csv users.csv Import-Csv data.csv -Delimiter ';' -Encoding utf8
Exporta objectos para CSV. -NoTypeInformation remove a linha de tipo no topo (default em PS 6+).
Get-Process | Export-Csv processes.csv -NoTypeInformation $data | Export-Csv out.csv -Encoding utf8 -Delimiter ';'
Rede
Cliente HTTP completo. Devolve a resposta como objecto com .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
Cliente HTTP que parseia automaticamente JSON ou XML para objectos. Mais usado para APIs REST. Alias irm.
Invoke-RestMethod https://api.github.com/users/octocat irm $url -Method POST -Body ($obj | ConvertTo-Json) -ContentType 'application/json'
Testa conectividade TCP a um host e porta. Só existe no Windows. Em Linux/macOS usa Test-Connection -TcpPort (PS 7+).
Test-NetConnection google.com -Port 443 Test-NetConnection -ComputerName 8.8.8.8 -TraceRoute
Equivalente a ping. -Count limita pacotes, -Quiet devolve só $true ou $false.
Test-Connection google.com -Count 4 Test-Connection 8.8.8.8 -Quiet # bool
Módulos
Lista módulos. -ListAvailable mostra todos os instalados, não só os carregados.
Get-Module Get-Module -ListAvailable Get-Module -Name Pester
Carrega um módulo na sessão actual. -Force recarrega se já estiver importado.
Import-Module Pester Import-Module .\MeuModulo.psm1 -Force
Instala módulos da PowerShell Gallery. -Scope CurrentUser evita pedir permissões de admin.
Install-Module Pester -Scope CurrentUser Install-Module Az -Force -AllowClobber
Procura módulos disponíveis na PowerShell Gallery.
Find-Module Az* Find-Module -Tag azure
Avançado
Corre código em background. Receive-Job recolhe os resultados, -Wait bloqueia até estar pronto.
$j = Start-Job { Get-Process }
Receive-Job $j -Wait -AutoRemoveJob
Get-Job | Remove-JobBackground jobs leves baseados em threads (mais rápidos que Start-Job). Embutido em PS 7+, em 5.1 instala com Install-Module ThreadJob.
$j = Start-ThreadJob { 1..10 | %{ $_ * 2 } }
$urls | ForEach-Object -Parallel { iwr $_ } -ThrottleLimit 5Mede o tempo de execução de um bloco. Devolve TimeSpan com TotalSeconds, TotalMilliseconds, etc.
Measure-Command { Get-ChildItem -Recurse }
(Measure-Command { ./script.ps1 }).TotalSecondsCorre comandos numa máquina remota via WinRM. Suporta sessões persistentes com -Session.
Invoke-Command -ComputerName server01 -ScriptBlock { Get-Service }
Invoke-Command -Session $s -ScriptBlock { hostname }Pausa a execução por N segundos ou milissegundos.
Start-Sleep -Seconds 5 Start-Sleep -Milliseconds 250
Referência
Ao contrário de bash, o pipeline em PowerShell transporta objectos com propriedades e métodos. Cada cmdlet pode aceder directamente a .Length, .Name, .CPU sem parsear texto.
Get-Process | Sort-Object CPU -Descending | Select-Object -First 5 # objectos fluem entre comandos com propriedades preservadas Get-ChildItem | Where-Object Length -gt 1MB # Each item retains its full type — pode aceder a .Length, .Name, etc. Get-Service | Group-Object Status | Format-Table Name, Count
A codificação por defeito mudou entre as versões. Saber qual está activa evita BOMs e caracteres trocados em scripts e logs partilhados com outras ferramentas.
- Default varia por cmdlet: Out-File usa UTF-16 LE com BOM, Set-Content usa Default (ANSI/Windows-1252).
- Nenhum produz UTF-8 sem -Encoding. Passa sempre -Encoding utf8 para ficheiros partilhados com ferramentas Unix.
- Default: UTF-8 sem BOM.
- Comportamento alinhado com o ecossistema. Em ambos, -Encoding utf8 garante UTF-8.
Set-Content file.txt 'texto' -Encoding utf8
Out-File log.txt -Encoding utf8 -InputObject $data
[System.IO.File]::WriteAllText('file.txt', 'texto', [System.Text.UTF8Encoding]::new($false))PowerShell distingue erros terminantes de não terminantes. Cmdlets falham silenciosamente por defeito, usa -ErrorAction Stop para forçar try/catch a apanhá-los.
Continue— comportamento padrão, mostra erro e continua.Stop— transforma em erro terminante (captável).SilentlyContinue— esconde o erro mas $? fica $false.Ignore— esconde e não regista em $Error.
$?— $true se o último comando teve sucesso.$LASTEXITCODE— exit code do último executável nativo.$Error[0]— objecto do último erro registado.
try {
Get-Item .\file -ErrorAction Stop
} catch [System.IO.FileNotFoundException] {
Write-Warning "ficheiro não encontrado"
} catch {
Write-Error $_.Exception.Message
}
# verificar saída de processo nativo
git status
if ($LASTEXITCODE -ne 0) { throw "git falhou" }Windows PowerShell 5.1 (powershell.exe) e PowerShell 7+ (pwsh.exe) têm sintaxe e features diferentes. Estes pormenores partem scripts ao passar de uma versão para a outra.
A && B / A || B— Os operadores && e || só existem em PS 7+. Em 5.1 usa: A; if ($?) { B }$x ? a : b— O operador ternário ?: só existe em PS 7+. Em 5.1 usa if/else.$x ?? y— O operador null-coalescing ?? só existe em PS 7+.ConvertFrom-Json -AsHashtable— ConvertFrom-Json -AsHashtable só existe em PS 6+.ForEach-Object -Parallel— ForEach-Object -Parallel só existe em PS 7+.
Combinações frequentes para automação e administração. Cada uma resolve uma tarefa específica num único pipeline.
- 01.Encontra ficheiros maiores que 100MB recursivamente.
Get-ChildItem -Recurse -File | Where-Object Length -gt 100MB - 02.Lista os 10 ficheiros maiores no directório actual.
Get-ChildItem | Sort-Object Length -Descending | Select-Object -First 10 - 03.Mostra os 10 processos que mais memória consomem.
Get-Process | Sort-Object WS -Descending | Select-Object -First 10 - 04.Mostra os 10 processos que mais CPU consomem.
Get-Process | Sort-Object CPU -Descending | Select-Object -First 10 - 05.Conta o número total de ficheiros recursivamente.
Get-ChildItem -Recurse -File | Measure-Object | Select-Object -ExpandProperty Count - 06.Apaga todos os ficheiros .tmp recursivamente.
Get-ChildItem -Recurse -Filter *.tmp | Remove-Item - 07.Pesquisa TODO em todos os ficheiros TypeScript.
Get-ChildItem -Recurse -File | Where-Object Extension -in '.ts','.tsx' | Select-String 'TODO' - 08.Obtém o IP público externo da máquina actual.
(Invoke-WebRequest ifconfig.me -UseBasicParsing).Content.Trim() - 09.Lista portas TCP em escuta com o processo associado.
Get-NetTCPConnection -State Listen | Select-Object LocalAddress,LocalPort,OwningProcess - 10.Acompanha um log ao vivo começando pelas últimas 100 linhas.
Get-Content app.log -Wait -Tail 100 - 11.Obtém data e hora actuais num formato pronto para nomes de ficheiro.
Get-Date -Format 'yyyy-MM-dd_HH-mm-ss' - 12.Cria um backup zip com a data no nome do ficheiro.
Compress-Archive -Path .\src -DestinationPath "backup-$(Get-Date -Format yyyy-MM-dd).zip" - 13.Formata e imprime JSON expandido para máxima legibilidade.
Get-Content data.json | ConvertFrom-Json | ConvertTo-Json -Depth 10 - 14.Lista todas as variáveis de ambiente ordenadas por nome.
Get-ChildItem env: | Sort-Object Name - 15.Lista todos os serviços actualmente em execução.
Get-Service | Where-Object Status -eq 'Running' - 16.Testa se uma porta TCP está aberta num host remoto.
Test-NetConnection google.com -Port 443 - 17.Mostra o espaço livre em cada disco do sistema.
Get-Volume | Select-Object DriveLetter, SizeRemaining, Size - 18.Mostra os últimos 20 comandos do histórico da sessão.
Get-History | Select-Object -Last 20 - 19.Mostra o caminho completo de um comando (equivalente a which).
(Get-Command npm).Source - 20.Lista ficheiros modificados nos últimos 7 dias.
Get-ChildItem -Recurse | Where-Object { $_.LastWriteTime -gt (Get-Date).AddDays(-7) }