Von Jens Ihle | Mit Unterstützung unseres Dozenten Alex

oder nur für das aktuelle Fenster (am sichersten)

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Was dieser Code genau macht:
Stufe 1 (Der Parser – Die „Grammatik-Prüfung“):
Struktur-Check: Prüft, ob du Klammern vergessen hast { [ ( oder ob diese falsch verschachtelt sind.
Zeichenketten: Identifiziert nicht geschlossene Anführungszeichen “ ‚, die oft dazu führen, dass der gesamte restliche Code als Text interpretiert wird.
Logik-Fundament: Erkennt harte Syntax-Fehler wie falsche Operatoren (z. B. 1 + / 2) oder ungültige Variablennamen.
Vorteil: Er arbeitet extrem schnell (Millisekunden), zeigt die exakte Zeile des Fehlers und bildet die Basis für alle weiteren Stufen.

Stufe 2 (Commandlet-Check – Die „Existenz-Prüfung“):
AST-Technologie: Das Script nutzt den sogenannten AST (Abstract Syntax Tree). Im Gegensatz zu einer einfachen Textsuche versteht das Script die echte Struktur und weiß genau, was ein Befehl, ein Parameter oder ein einfacher Textwert ist.
Lokaler Abgleich: Es führt für jeden identifizierten Befehl ein Get-Command im Hintergrund aus.
Fehlererkennung: Wenn du z. B. Get-Hundekuchen oder Invoke-Zaubertrick schreibst, prüft das Script gegen alle auf deinem Windows-PC installierten Module. Ist der Befehl unbekannt, erhältst du eine Warnung mit Zeilennummer.

Stufe 3 (PSScriptAnalyzer – Die „Best-Practice-Prüfung“):
Intelligentes Nachladen: Das Script prüft, ob das Profi-Modul PSScriptAnalyzer lokal vorhanden ist. Falls nicht, wird es automatisch über die PowerShell Gallery (Online) für den aktuellen Nutzer installiert – ohne dass Admin-Rechte erforderlich sind.
Qualitäts-Check: Es findet „schlechten Stil“, wie z. B. die Verwendung von Aliasen (ls statt Get-ChildItem, ps statt Get-Process) oder unbenutzte Variablen.

Was wäre ohne PSScriptAnalyzer? Du würdest:
– mehr Zeit mit Debugging verbringen
– mehr Fehler erst im Betrieb entdecken
– weniger konsistenten Code haben
– Sicherheitsrisiken leichter übersehen
– Best Practices nur durch Erfahrung oder Zufall lernen
Kurz: Du arbeitest „blind“ und hoffst, dass alles gutgeht.

Sicherheit: Es warnt vor riskanten Praktiken, wie z. B. im Code hartgespeicherten Passwörtern oder unsicheren Befehlskombinationen.

Besonderheiten der „Smart-Logik“ in diesem Script:
Kein Abbruch: Im Gegensatz zum Standard-Verhalten von PowerShell bricht dieses Script niemals ab. Es versucht, so viele Informationen wie möglich über das gesamte Dokument zu sammeln.
Anti-Rauschen-Filter (Folgefehler-Unterdrückung): Wenn in einer Zeile bereits ein harter Syntaxfehler (Stufe 1) gefunden wurde, werden weitere Warnungen (Stufe 2 & 3) für dieselbe Zeile unterdrückt. Das verhindert, dass du von 20 Fehlermeldungen überschwemmt wirst, die alle nur eine einzige Ursache haben.
UTF8-Konformität: Durch die explizite Codierung werden Umlaute (ä, ö, ü) und Sonderzeichen sowohl in der Windows-Konsole als auch in der Logdatei auf dem Desktop korrekt dargestellt.
Professionelles Logging: Alle Ergebnisse werden sortiert nach Zeilennummern ausgegeben und gleichzeitig dauerhaft in einer Datei: „FullAnalysis.log“ auf deinem Desktop gespeichert.
Download:
Das Modul „PSScriptAnalyzer„wird standardmäßig aus der PowerShell Gallery geladen. Das ist das offizielle, von Microsoft betriebene Zentralregister für PowerShell-Erweiterungen.

Webseite (zum Ansehen):
https://www.powershellgallery.com/packages/PSScriptAnalyzer

API-Schnittstelle (wo die PowerShell technisch anfragt):
https://www.powershellgallery.com/api/v2

Hintergrundinfo:
Sicherheit: Die PowerShell Gallery ist der weltweite Standard für PowerShell-Module. Microsoft scannt die dort hochgeladenen Module automatisch auf bekannte Schadsoftware.
Provider: Um den Download durchzuführen, nutzt Windows im Hintergrund einen sogenannten „Provider“ namens NuGet.
Das Modul PSScriptAnalyzer ist ein Analysewerkzeug für PowerShell‑Code. Es prüft Skripte und Module statisch, also ohne sie auszuführen, und bewertet deren Qualität anhand eines umfangreichen Regelwerks. Diese Regeln basieren auf Best Practices, die vom PowerShell‑Team und der Community entwickelt wurden.

Vertrauenswürdigkeit: Wenn du das Modul zum allerersten Mal lädst, fragt PowerShell: „Möchten Sie das Modul aus dem unvertrauenswürdigen Repository installieren?“. Das Modul PSScriptAnalyzer ist ein Analysewerkzeug für PowerShell‑Code. Es prüft Skripte und Module statisch, also ohne sie auszuführen, und bewertet deren Qualität anhand eines umfangreichen Regelwerks. Diese Regeln basieren auf Best Practices, die vom PowerShell‑Team und der Community entwickelt wurden. Das liegt daran, dass die PowerShell Gallery standardmäßig als „Untrusted“ markiert ist, um sicherzustellen, dass der Nutzer den Download bewusst bestätigt.
Zusammenfassend: Es ist vergleichbar mit dem „App Store“ oder „Google Play Store“, nur eben speziell für PowerShell-Befehle und betrieben von Microsoft.

<#
============================================================
PROFI POWERSHELL SMART-ANALYZER (Safe-Version)
============================================================
#>

[CmdletBinding()]
param(
    [Parameter(Mandatory = $true)]
    [string]$ScriptPath
)

# UTF8-Fix fuer Konsole
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

# Pfad fuer das Log auf dem Desktop ermitteln
$desktop = [System.Environment]::GetFolderPath([System.Environment+SpecialFolder]::Desktop)
$LogFile = Join-Path $desktop "FullAnalysis.log"

# Ergebnisspeicher
$AnalysisResults = @()

function Add-Result {
    param($Line, $Type, $Message, $Level)
    $obj = [PSCustomObject]@{
        Line    = $Line
        Type    = $Type
        Message = $Message
        Level   = $Level
    }
    $script:AnalysisResults += $obj
}

# --- 1. DATEI LADEN ---
if (-not (Test-Path $ScriptPath)) {
    Write-Host "FEHLER: Datei nicht gefunden." -ForegroundColor Red
    return
}

try {
    $Code = Get-Content $ScriptPath -Raw -Encoding UTF8 -ErrorAction Stop
    $CodeLines = $Code -split '\r?\n'
} catch {
    Write-Host "FEHLER: Datei konnte nicht gelesen werden." -ForegroundColor Red
    return
}

Write-Host "--- STARTE VOLLSTAENDIGE ANALYSE ---" -ForegroundColor Cyan

# --- 2. SCHRITT: SYNTAX-ANALYSE (Parser) ---
$errors = @()
$ast = [System.Management.Automation.Language.Parser]::ParseInput($Code, [ref]$null, [ref]$errors)

foreach ($err in $errors) {
    Add-Result -Line $err.Extent.StartLineNumber -Type "SYNTAX" -Message $err.Message -Level "ERROR"
}

# --- 3. SCHRITT: COMMANDLET-EXISTENZ (AST) ---
$commands = $ast.FindAll({ $args[0] -is [System.Management.Automation.Language.CommandAst] }, $true)
foreach ($cmdAst in $commands) {
    $cmdName = $cmdAst.GetCommandName()
    if ($cmdName -and $cmdName -notmatch '\$|\\|\/') {
        if (-not (Get-Command $cmdName -ErrorAction SilentlyContinue)) {
            $existing = $AnalysisResults | Where-Object { $_.Line -eq $cmdAst.Extent.StartLineNumber -and $_.Type -eq "SYNTAX" }
            if (-not $existing) {
                Add-Result -Line $cmdAst.Extent.StartLineNumber -Type "BEFEHL" -Message "Befehl '$cmdName' unbekannt." -Level "WARN"
            }
        }
    }
}

# --- 4. SCHRITT: BEST PRACTICE (Online-Modul) ---
if (-not (Get-Module -ListAvailable -Name PSScriptAnalyzer)) {
    Write-Host "Info: Modul PSScriptAnalyzer wird geladen..." -ForegroundColor Gray
    try { Install-Module -Name PSScriptAnalyzer -Scope CurrentUser -Force -Confirm:$false -ErrorAction SilentlyContinue } catch {}
}

if (Get-Module -ListAvailable -Name PSScriptAnalyzer) {
    $analyzerResults = Invoke-ScriptAnalyzer -Path $ScriptPath -ErrorAction SilentlyContinue
    foreach ($res in $analyzerResults) {
        $existing = $AnalysisResults | Where-Object { $_.Line -eq $res.Line -and $_.Type -eq "SYNTAX" }
        if (-not $existing) {
            Add-Result -Line $res.Line -Type "STIL" -Message $res.Message -Level "INFO"
        }
    }
}

# --- 5. AUSGABE ---
$timestamp = Get-Date -Format "yyyy-MM-dd HH:mm"
"--- Analyse vom $timestamp ---" | Out-File $LogFile -Append -Encoding UTF8

if ($AnalysisResults.Count -eq 0) {
    Write-Host "Keine Fehler gefunden!" -ForegroundColor Green
} else {
    foreach ($res in ($AnalysisResults | Sort-Object Line)) {
        $color = switch($res.Level) { "ERROR" {"Red"} "WARN" {"Yellow"} "INFO" {"White"} }
        $msg = "[Zeile $($res.Line)] [$($res.Type)] $($res.Message)"
        Write-Host $msg -ForegroundColor $color
        $msg | Out-File $LogFile -Append -Encoding UTF8
        if ($res.Line -gt 0 -and $res.Line -le $CodeLines.Count) {
            Write-Host "   Code: $($CodeLines[$res.Line-1].Trim())" -ForegroundColor Gray
        }
    }
}

Write-Host "--- ANALYSE BEENDET ---" -ForegroundColor Cyan
Write-Host "Log: $LogFile"

Speichern als: „Check-MyScript.ps1„

TestCode

<#
============================================================
ULTIMATIVER TEST-CODE FÜR SMART-ANALYZER
============================================================
Dieses Script enthält absichtliche Fehler für alle Stufen:
1. Syntax-Fehler (Parser)
2. Unbekannte Befehle (AST/Commandlet-Check)
3. Best-Practice-Verstöße (PSScriptAnalyzer)
============================================================
#>

# --- STUFE 3: Best-Practice & Stil (PSScriptAnalyzer) ---
$NichtGenutzteVariable = "Ich werde definiert, aber nie aufgerufen"
dir C:\Windows  # FEHLER: 'dir' ist ein Alias (sollte Get-ChildItem sein)
echo "Hallo"    # FEHLER: 'echo' ist ein Alias (sollte Write-Output sein)

# --- STUFE 2: Unbekannte Commandlets (Existenz-Prüfung) ---
Start-GalaxyWarp -Speed 10  # FEHLER: Dieser Befehl existiert nicht
Get-KaffeeInventar -Sorte "Arabica"  # FEHLER: Unbekannter Befehl

# --- STUFE 1: Harte Syntax-Fehler (Parser) ---
# FEHLER: Ein If-Block ohne schließende Klammer '}'
if ($true) {
    Write-Host "Die Klammer unter mir fehlt!"

# FEHLER: Ein String, bei dem das schließende Anführungszeichen fehlt
$Fehlermeldung = "Hier wurde das Ende der Zeichenkette vergessen

Speichern als: „TestFehler.ps1„

Script aufrufen:

# 1. Ausführung von eigenen Scripten erlauben (falls noch nicht dauerhaft gesetzt)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

# 2. In deinen Projektordner wechseln
cd "E:\1.) Archiv New\CloudCommand\Neu\Code\SecurityFramework\"

# 3. Die Konsole auf UTF8 einstellen (für schöne Umlaute)
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

# 4. Den Checker auf die Testdatei starten
.\Check-MyScript.ps1 -ScriptPath ".\TestFehler.ps1"

Analyse startet:

PS C:\WINDOWS\system32> # 1. Ausführung von eigenen Scripten erlauben (falls noch nicht dauerhaft gesetzt)
PS C:\WINDOWS\system32> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
PS C:\WINDOWS\system32>
PS C:\WINDOWS\system32> # 2. In deinen Projektordner wechseln
PS C:\WINDOWS\system32> cd "E:\1.) Archiv New\CloudCommand\Neu\Code\SecurityFramework\"
PS E:\1.) Archiv New\CloudCommand\Neu\Code\SecurityFramework>
PS E:\1.) Archiv New\CloudCommand\Neu\Code\SecurityFramework> # 3. Die Konsole auf UTF8 einstellen (für schöne Umlaute)
PS E:\1.) Archiv New\CloudCommand\Neu\Code\SecurityFramework> [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
PS E:\1.) Archiv New\CloudCommand\Neu\Code\SecurityFramework>
PS E:\1.) Archiv New\CloudCommand\Neu\Code\SecurityFramework> # 4. Den Checker auf die Testdatei starten
PS E:\1.) Archiv New\CloudCommand\Neu\Code\SecurityFramework> .\Check-MyScript.ps1 -ScriptPath ".\TestFehler.ps1"
--- STARTE VOLLSTAENDIGE ANALYSE ---
Info: Modul PSScriptAnalyzer wird geladen... # 5. Bestätige den Download von Modul PSScriptAnalyzer 

Abfrage zum Download von: „Modul PSScriptAnalyzer„.
Was es macht:
– Analysiert PowerShell‑Code auf Fehler, Warnungen und Stilprobleme.
– Erkennt typische Stolperfallen, z. B. uninitialisierte Variablen, unsichere Befehle wie „Invoke-Expression“ oder unsaubere Formatierung.
– Gibt konkrete Verbesserungsvorschläge, sogenannte DiagnosticResults.
– Unterstützt anpassbare Regelsets, sodass du eigene Regeln aktivieren, deaktivieren oder definieren kannst.
– Kann Code automatisch formatieren, um ein einheitliches Erscheinungsbild sicherzustellen.

Der NuGet-Anbieter ist erforderlich, um den Vorgang fortzusetzen.
PowerShellGet erfordert die NuGet-Anbieterversion 2.8.5.201 oder höher für die Interaktion mit NuGet-basierten
Repositorys. Der NuGet-Anbieter muss in "C:\Program Files\PackageManagement\ProviderAssemblies" oder
"C:\Users\jihle\AppData\Local\PackageManagement\ProviderAssemblies" verfügbar sein. Sie können den NuGet-Anbieter auch
durch Ausführen von 'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force' installieren. Möchten Sie
den NuGet-Anbieter jetzt durch PowerShellGet installieren und importieren lassen?
[J] Ja  [N] Nein  [H] Anhalten  [?] Hilfe (Standard ist "J"): J

Das finale Ergebnis bei fehlerhaften Code:

[Zeile ] [STIL] Missing BOM encoding for non-ASCII encoded file 'TestFehler.ps1'
[Zeile 13] [STIL] The variable 'NichtGenutzteVariable' is assigned but never used.
   Code: $NichtGenutzteVariable = "Ich werde definiert, aber nie aufgerufen"
[Zeile 14] [STIL] 'dir' is an alias of 'Get-ChildItem'. Alias can introduce possible problems and make scripts hard to maintain. Please consider changing alias to its full content.
   Code: dir C:\Windows  # FEHLER: 'dir' ist ein Alias (sollte Get-ChildItem sein)
[Zeile 15] [STIL] 'echo' is an alias of 'Write-Output'. Alias can introduce possible problems and make scripts hard to maintain. Please consider changing alias to its full content.
   Code: echo "Hallo"    # FEHLER: 'echo' ist ein Alias (sollte Write-Output sein)
[Zeile 18] [BEFEHL] Befehl 'Start-GalaxyWarp' unbekannt.
   Code: Start-GalaxyWarp -Speed 10  # FEHLER: Dieser Befehl existiert nicht
[Zeile 19] [BEFEHL] Befehl 'Get-KaffeeInventar' unbekannt.
   Code: Get-KaffeeInventar -Sorte "Arabica"  # FEHLER: Unbekannter Befehl
[Zeile 23] [SYNTAX] Die schließende "}" fehlt im Anweisungsblock oder der Typdefinition.
   Code: if ($true) {
[Zeile 24] [STIL] File 'TestFehler.ps1' uses Write-Host. Avoid using Write-Host because it might not work in all hosts, does not work when there is no host, and (prior to PS 5.0) cannot be suppressed, captured, or redirected. Instead, use Write-Output, Write-Verbose, or Write-Information.
   Code: Write-Host "Die Klammer unter mir fehlt!"
[Zeile 27] [SYNTAX] Die Zeichenfolge hat kein Abschlusszeichen: ".
   Code: $Fehlermeldung = "Hier wurde das Ende der Zeichenkette vergessen
--- ANALYSE BEENDET ---
Log: C:\Users\jihle\Desktop\FullAnalysis.log

1. Das heruntergeladene Modul deinstallieren:

Uninstall-Module -Name PSScriptAnalyzer -AllVersions -Force

2. Überprüfen, ob es weg ist:

Get-Module -ListAvailable -Name PSScriptAnalyzer

Falls das Modul „hartnäckig“ ist (Manuelles Löschen)
Manchmal blockiert Windows das Löschen, wenn das Modul gerade im Hintergrund noch geladen ist. Falls der obige Befehl einen Fehler wirft, mache Folgendes:

PowerShell schließen und neu öffnen (um alle aktiven Sperren zu lösen).
Diesen Befehl nutzen, um den Ordner direkt zu finden und zu löschen:

$path = (Get-Module -ListAvailable -Name PSScriptAnalyzer).ModuleBase
if ($path) { Remove-Item -Path $path -Recurse -Force -Confirm:$false; Write-Host "Ordner geloescht." }