PowerShell Spickzettel

Listet Dateien und Verzeichnisse. Aliase ls, gci, dir. -Recurse läuft durch alles, -Force zeigt versteckte.

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

Wechselt das aktuelle Verzeichnis. Alias cd. Unterstützt - für das vorherige und ~ für das Home.

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

Zeigt den aktuellen Pfad. Alias pwd.

Get-Location
pwd

Prüft, ob ein Pfad existiert. Gibt $true oder $false zurück.

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

Speichert das aktuelle Verzeichnis auf einem Stack (Push) und kehrt später zurück (Pop). Nützlich in Skripten.

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

Löst einen relativen Pfad zu einem absoluten auf, oder umgekehrt mit -Relative.

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

Erstellt Dateien, Verzeichnisse oder Symlinks. -ItemType legt den Typ fest. -Force auf bestehender Datei kürzt sie.

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

Kopiert Dateien oder Verzeichnisse. -Recurse für Bäume, -Force überschreibt das Ziel.

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

Verschiebt oder benennt Dateien und Verzeichnisse um.

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

Löscht Dateien oder Verzeichnisse. -Recurse -Force löscht ohne Bestätigung (gefährlich).

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

Benennt Dateien um. Akzeptiert ScriptBlock in -NewName für Massenumbenennungen.

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

Holt Informationen zu einem Element (Length, LastWriteTime, etc.). Liest keinen Inhalt, nur Metadaten.

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

Liest den Inhalt einer Datei. -TotalCount wie head, -Tail wie tail, -Wait folgt wie 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

Schreibt Inhalt in eine Datei und überschreibt sie. -Encoding utf8 vermeidet den PS 5.1 Default UTF-16 mit BOM.

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

Fügt Inhalt an eine bestehende Datei an. Entspricht >> in bash.

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

Leitet Ausgabe in eine Datei um. -Append hängt an, -Encoding steuert die Codierung.

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

Leert den Inhalt einer Datei, ohne sie zu löschen.

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

Filtert Objekte in der Pipeline nach Bedingung. Aliase ? und where. Unterstützt Kurzsyntax Eigenschaft -op Wert.

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

Sortiert Objekte nach Eigenschaft. -Descending kehrt um, -Unique entfernt Duplikate.

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

Wählt N Objekte aus der Pipeline oder Eigenschaften jedes Objekts. -ExpandProperty extrahiert den Wert.

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

Iteriert durch die Pipeline und wendet einen Block auf jedes Objekt an. Aliase % und foreach. -Parallel parallel (PS 7+).

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

Zählt, summiert, Durchschnitt, Max oder Min einer Sammlung. -Line, -Word, -Character für Text.

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

Gruppiert Objekte nach Eigenschaft. Nützlich um Vorkommen zu zählen oder Dictionaries mit -AsHashTable zu bauen.

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

Sucht Muster in Strings oder Dateien. Das grep-Äquivalent. -Pattern akzeptiert Regex, -SimpleMatch deaktiviert es.

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

Zeigt verfügbare Cmdlets mit Filter nach Name, Modul oder Typ. (Get-Command npm).Source liefert den Pfad.

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

Zeigt Eigenschaften und Methoden eines Objekts. Unverzichtbar um zu entdecken, was man mit einem Typ tun kann.

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

Zeigt Hilfe zu Cmdlets oder about_*-Themen. -Examples zeigt Beispiele, -Online öffnet die Web-Version.

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

Variablen beginnen mit $ und brauchen keine Deklaration. Unterstützen Arrays (@()) und Hashtables (@{}).

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

Liest und setzt Umgebungsvariablen. Get-ChildItem env: listet alle. Änderung gilt nur in der aktuellen Sitzung.

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

Null-Wert. Bei Vergleichen $null links setzen ($null -eq $x), um Überraschungen mit Arrays zu vermeiden.

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

Typumwandlung mit [typ]. Funktioniert für int, string, datetime, typisierte Arrays, Regex.

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

Legt den Gültigkeitsbereich einer Variable fest: global (gesamte Sitzung), script (diese Datei) oder local (diese Funktion).

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

Doppelte Anführungszeichen erweitern $var und $(expr). Einfache sind literal und erweitern nichts.

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

Mehrzeilige Strings (Here-Strings). @"..."@ erweitert Variablen, @'...'@ ist literal. Schließendes Token muss in Spalte 0 stehen.

@"
linha 1 com $nome
linha 2
"@

@'
literal $nome
'@

Format-Operator im printf-Stil. Unterstützt Zahlen, Daten und Ausrichtung ({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)

String-Operationen: -replace nutzt Regex, -split teilt in Array, -join verbindet Array zu String.

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

Bedingungsstruktur. Nutzt PowerShell-Operatoren (-eq, -lt) statt == oder <.

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

Alternative zu verketteten ifs. -Regex und -Wildcard aktivieren Muster, -File liest Zeilen aus einer Datei.

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

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

Schleifen über Sammlungen (foreach), mit Zähler (for), während Bedingung (while), oder mindestens einmal (do/while).

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

Fehlerbehandlung. Um nicht-terminierende Fehler abzufangen, nutze -ErrorAction Stop am Cmdlet.

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

break verlässt die Schleife, continue springt zur nächsten Iteration, return verlässt die Funktion.

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

Vergleichsoperatoren. Es gibt kein == in PowerShell, nutze immer -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

Weitere Operatoren: -like nutzt Wildcards, -match nutzt Regex, -contains prüft Zugehörigkeit, -in ist die Umkehrung.

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

Logische Operatoren. -and, -or, -not, -xor. ! ist Alias für -not.

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

Listet Prozesse mit Eigenschaften (CPU, WS, Id, ProcessName). Ohne Argument werden alle aufgelistet.

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

Beendet Prozesse nach Name oder Id. -Force vermeidet Bestätigung. Kann Objekte aus der Pipeline empfangen.

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

Startet ein Programm. -Wait blockiert bis zum Ende, -NoNewWindow läuft in der aktuellen Konsole, -Verb RunAs erhöht.

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

Wartet auf das Ende eines Prozesses. -Timeout bricht nach N Sekunden ab.

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

Führt einen Befehl oder ein Skript aus. Nötig bei Pfaden mit Leerzeichen oder dynamischen Aufrufen.

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

Konvertiert JSON in PowerShell-Objekte. -AsHashtable liefert Hashtable (PS 6+) statt PSCustomObject.

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

Konvertiert PowerShell-Objekte in JSON. -Depth steuert die Tiefe (Default 2, meist zu niedrig).

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

Liest CSV in Objekte mit Eigenschaften. -Delimiter für ; oder andere, -Header wenn die Datei keinen Header hat.

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

Exportiert Objekte als CSV. -NoTypeInformation entfernt die Typzeile oben (Default in PS 6+).

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

Vollwertiger HTTP-Client. Liefert die Antwort als Objekt mit .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

HTTP-Client, der JSON oder XML automatisch in Objekte parst. Häufigster für REST-APIs. Alias irm.

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

Testet TCP-Konnektivität zu Host und Port. Nur Windows. Auf Linux/macOS nutze Test-Connection -TcpPort (PS 7+).

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

Ping-Äquivalent. -Count begrenzt Pakete, -Quiet gibt nur $true oder $false zurück.

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

Listet Module. -ListAvailable zeigt alle installierten, nicht nur die geladenen.

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

Lädt ein Modul in die aktuelle Sitzung. -Force lädt neu, falls bereits importiert.

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

Installiert Module aus der PowerShell Gallery. -Scope CurrentUser vermeidet Admin-Rechte.

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

Sucht nach verfügbaren Modulen in der PowerShell Gallery.

Find-Module Az*
Find-Module -Tag azure

Führt Code im Hintergrund aus. Receive-Job holt die Ergebnisse, -Wait blockiert bis fertig.

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

Leichte Thread-basierte Background-Jobs (schneller als Start-Job). In PS 7+ enthalten, in 5.1 mit Install-Module ThreadJob installieren.

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

Misst die Ausführungszeit eines Blocks. Liefert TimeSpan mit TotalSeconds, TotalMilliseconds, etc.

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

Führt Befehle auf einer Remote-Maschine via WinRM aus. Unterstützt persistente Sessions mit -Session.

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

Pausiert die Ausführung für N Sekunden oder Millisekunden.

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