<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="de">
	<id>https://mediawiki.gerhardfoschum.me/index.php?action=history&amp;feed=atom&amp;title=Powershell_-_Funktionen_und_Skripte</id>
	<title>Powershell - Funktionen und Skripte - Versionsgeschichte</title>
	<link rel="self" type="application/atom+xml" href="https://mediawiki.gerhardfoschum.me/index.php?action=history&amp;feed=atom&amp;title=Powershell_-_Funktionen_und_Skripte"/>
	<link rel="alternate" type="text/html" href="https://mediawiki.gerhardfoschum.me/index.php?title=Powershell_-_Funktionen_und_Skripte&amp;action=history"/>
	<updated>2026-11-16T17:46:51Z</updated>
	<subtitle>Versionsgeschichte dieser Seite in Gerhards Wiki</subtitle>
	<generator>MediaWiki 1.44.0</generator>
	<entry>
		<id>https://mediawiki.gerhardfoschum.me/index.php?title=Powershell_-_Funktionen_und_Skripte&amp;diff=88&amp;oldid=prev</id>
		<title>Gerhard: /* Return-Werte */</title>
		<link rel="alternate" type="text/html" href="https://mediawiki.gerhardfoschum.me/index.php?title=Powershell_-_Funktionen_und_Skripte&amp;diff=88&amp;oldid=prev"/>
		<updated>2025-11-25T08:25:44Z</updated>

		<summary type="html">&lt;p&gt;&lt;span class=&quot;autocomment&quot;&gt;Return-Werte&lt;/span&gt;&lt;/p&gt;
&lt;table style=&quot;background-color: #fff; color: #202122;&quot; data-mw=&quot;interface&quot;&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;col class=&quot;diff-marker&quot; /&gt;
				&lt;col class=&quot;diff-content&quot; /&gt;
				&lt;tr class=&quot;diff-title&quot; lang=&quot;de&quot;&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;← Nächstältere Version&lt;/td&gt;
				&lt;td colspan=&quot;2&quot; style=&quot;background-color: #fff; color: #202122; text-align: center;&quot;&gt;Version vom 25. November 2025, 08:25 Uhr&lt;/td&gt;
				&lt;/tr&gt;&lt;tr&gt;&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot; id=&quot;mw-diff-left-l117&quot;&gt;Zeile 117:&lt;/td&gt;
&lt;td colspan=&quot;2&quot; class=&quot;diff-lineno&quot;&gt;Zeile 117:&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;&amp;lt;/syntaxhighlight&amp;gt;&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;−&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #ffe49c; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;{{Hinweis|In PowerShell wird ALLES, was ausgegeben wird, zurückgegeben. Verwende &amp;lt;code&amp;gt;| Out-Null&amp;lt;/code&amp;gt; oder &amp;lt;code&amp;gt;$null =&amp;lt;/code&amp;gt; um unerwünschte Ausgaben zu unterdrücken.}}&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot; data-marker=&quot;+&quot;&gt;&lt;/td&gt;&lt;td style=&quot;color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #a3d3ff; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;{{Hinweis|In PowerShell wird ALLES, was ausgegeben wird, zurückgegeben. Verwende &amp;lt;code&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&amp;gt;&amp;lt;nowiki&lt;/ins&gt;&amp;gt;| Out-Null&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&amp;lt;/nowiki&amp;gt;&lt;/ins&gt;&amp;lt;/code&amp;gt; oder &amp;lt;code&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&amp;gt;&amp;lt;nowiki&lt;/ins&gt;&amp;gt;$null =&lt;ins style=&quot;font-weight: bold; text-decoration: none;&quot;&gt;&amp;lt;/nowiki&amp;gt;&lt;/ins&gt;&amp;lt;/code&amp;gt; um unerwünschte Ausgaben zu unterdrücken.}}&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;br&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;tr&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;----&lt;/div&gt;&lt;/td&gt;&lt;td class=&quot;diff-marker&quot;&gt;&lt;/td&gt;&lt;td style=&quot;background-color: #f8f9fa; color: #202122; font-size: 88%; border-style: solid; border-width: 1px 1px 1px 4px; border-radius: 0.33em; border-color: #eaecf0; vertical-align: top; white-space: pre-wrap;&quot;&gt;&lt;div&gt;----&lt;/div&gt;&lt;/td&gt;&lt;/tr&gt;
&lt;/table&gt;</summary>
		<author><name>Gerhard</name></author>
	</entry>
	<entry>
		<id>https://mediawiki.gerhardfoschum.me/index.php?title=Powershell_-_Funktionen_und_Skripte&amp;diff=87&amp;oldid=prev</id>
		<title>Gerhard: Die Seite wurde neu angelegt: „== Kursübersicht ==  &#039;&#039;&#039;Voraussetzungen:&#039;&#039;&#039; Kurs 1-4 abgeschlossen  &#039;&#039;&#039;Lernziele:&#039;&#039;&#039; * Du schreibst eigene Funktionen * Du definierst und validierst Parameter * Du erstellst wiederverwendbare Skripte * Du verstehst Scopes und Return-Werte * Du dokumentierst deinen Code professionell * Du nutzt fortgeschrittene Funktions-Features  ----  == Modul 5.1: Grundlagen von Funktionen ==  === Was sind Funktionen? ===  Funktionen sind wiederverwendbare Code-Blöcke…“</title>
		<link rel="alternate" type="text/html" href="https://mediawiki.gerhardfoschum.me/index.php?title=Powershell_-_Funktionen_und_Skripte&amp;diff=87&amp;oldid=prev"/>
		<updated>2025-11-25T08:12:00Z</updated>

		<summary type="html">&lt;p&gt;Die Seite wurde neu angelegt: „== Kursübersicht ==  &amp;#039;&amp;#039;&amp;#039;Voraussetzungen:&amp;#039;&amp;#039;&amp;#039; Kurs 1-4 abgeschlossen  &amp;#039;&amp;#039;&amp;#039;Lernziele:&amp;#039;&amp;#039;&amp;#039; * Du schreibst eigene Funktionen * Du definierst und validierst Parameter * Du erstellst wiederverwendbare Skripte * Du verstehst Scopes und Return-Werte * Du dokumentierst deinen Code professionell * Du nutzt fortgeschrittene Funktions-Features  ----  == Modul 5.1: Grundlagen von Funktionen ==  === Was sind Funktionen? ===  Funktionen sind wiederverwendbare Code-Blöcke…“&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Neue Seite&lt;/b&gt;&lt;/p&gt;&lt;div&gt;== Kursübersicht ==&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Voraussetzungen:&amp;#039;&amp;#039;&amp;#039; Kurs 1-4 abgeschlossen&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Lernziele:&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
* Du schreibst eigene Funktionen&lt;br /&gt;
* Du definierst und validierst Parameter&lt;br /&gt;
* Du erstellst wiederverwendbare Skripte&lt;br /&gt;
* Du verstehst Scopes und Return-Werte&lt;br /&gt;
* Du dokumentierst deinen Code professionell&lt;br /&gt;
* Du nutzt fortgeschrittene Funktions-Features&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
== Modul 5.1: Grundlagen von Funktionen ==&lt;br /&gt;
&lt;br /&gt;
=== Was sind Funktionen? ===&lt;br /&gt;
&lt;br /&gt;
Funktionen sind wiederverwendbare Code-Blöcke, die eine bestimmte Aufgabe erfüllen:&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Vorteile:&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Wiederverwendbarkeit&amp;#039;&amp;#039;&amp;#039; - Einmal schreiben, mehrfach nutzen&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Wartbarkeit&amp;#039;&amp;#039;&amp;#039; - Änderungen an einer Stelle&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Lesbarkeit&amp;#039;&amp;#039;&amp;#039; - Abstraktionsebene erhöhen&lt;br /&gt;
* &amp;#039;&amp;#039;&amp;#039;Testbarkeit&amp;#039;&amp;#039;&amp;#039; - Isolierte Tests möglich&lt;br /&gt;
&lt;br /&gt;
=== Einfache Funktion ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
# Funktion ohne Parameter&lt;br /&gt;
function Say-Hello {&lt;br /&gt;
    Write-Host &amp;quot;Hallo Welt!&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Funktion aufrufen&lt;br /&gt;
Say-Hello&lt;br /&gt;
&lt;br /&gt;
# Funktion mit Code-Block&lt;br /&gt;
function Get-CurrentTime {&lt;br /&gt;
    $zeit = Get-Date -Format &amp;quot;HH:mm:ss&amp;quot;&lt;br /&gt;
    Write-Host &amp;quot;Aktuelle Zeit: $zeit&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
Get-CurrentTime&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Namenskonventionen ===&lt;br /&gt;
&lt;br /&gt;
PowerShell-Funktionen folgen der &amp;#039;&amp;#039;&amp;#039;Verb-Substantiv&amp;#039;&amp;#039;&amp;#039;-Konvention:&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Verb !! Verwendung !! Beispiel&lt;br /&gt;
|-&lt;br /&gt;
| Get || Daten abrufen || &amp;lt;code&amp;gt;Get-UserInfo&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Set || Werte setzen || &amp;lt;code&amp;gt;Set-Configuration&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| New || Erstellen || &amp;lt;code&amp;gt;New-LogEntry&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Remove || Löschen || &amp;lt;code&amp;gt;Remove-OldFiles&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Test || Prüfen || &amp;lt;code&amp;gt;Test-Connection&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Start || Starten || &amp;lt;code&amp;gt;Start-Backup&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Stop || Stoppen || &amp;lt;code&amp;gt;Stop-Service&amp;lt;/code&amp;gt;&lt;br /&gt;
|-&lt;br /&gt;
| Invoke || Ausführen || &amp;lt;code&amp;gt;Invoke-Command&amp;lt;/code&amp;gt;&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
# Genehmigte Verben anzeigen&lt;br /&gt;
Get-Verb&lt;br /&gt;
&lt;br /&gt;
# Nach Verben filtern&lt;br /&gt;
Get-Verb -Verb Get&lt;br /&gt;
Get-Verb -Group Data&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Tipp|Halte dich an die Verb-Nomen-Konvention für professionelle, konsistente Funktionen!}}&lt;br /&gt;
&lt;br /&gt;
=== Return-Werte ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
# Impliziter Return - letzte Ausgabe wird zurückgegeben&lt;br /&gt;
function Get-Summe {&lt;br /&gt;
    param($a, $b)&lt;br /&gt;
    $a + $b  # Wird automatisch zurückgegeben&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
$ergebnis = Get-Summe 5 10&lt;br /&gt;
Write-Host &amp;quot;Summe: $ergebnis&amp;quot;  # 15&lt;br /&gt;
&lt;br /&gt;
# Expliziter Return&lt;br /&gt;
function Get-Produkt {&lt;br /&gt;
    param($a, $b)&lt;br /&gt;
    return $a * $b&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
$ergebnis = Get-Produkt 5 10&lt;br /&gt;
Write-Host &amp;quot;Produkt: $ergebnis&amp;quot;  # 50&lt;br /&gt;
&lt;br /&gt;
# Mehrere Ausgaben&lt;br /&gt;
function Get-Statistik {&lt;br /&gt;
    param($zahlen)&lt;br /&gt;
    &lt;br /&gt;
    $summe = ($zahlen | Measure-Object -Sum).Sum&lt;br /&gt;
    $durchschnitt = ($zahlen | Measure-Object -Average).Average&lt;br /&gt;
    &lt;br /&gt;
    # Beide Werte werden zurückgegeben (als Array)&lt;br /&gt;
    $summe&lt;br /&gt;
    $durchschnitt&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
$stats = Get-Statistik @(1, 2, 3, 4, 5)&lt;br /&gt;
Write-Host &amp;quot;Summe: $($stats[0]), Durchschnitt: $($stats[1])&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Hinweis|In PowerShell wird ALLES, was ausgegeben wird, zurückgegeben. Verwende &amp;lt;code&amp;gt;| Out-Null&amp;lt;/code&amp;gt; oder &amp;lt;code&amp;gt;$null =&amp;lt;/code&amp;gt; um unerwünschte Ausgaben zu unterdrücken.}}&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
== Modul 5.2: Parameter ==&lt;br /&gt;
&lt;br /&gt;
=== Einfache Parameter ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
# Parameter-Block&lt;br /&gt;
function Greet-Person {&lt;br /&gt;
    param(&lt;br /&gt;
        $name&lt;br /&gt;
    )&lt;br /&gt;
    Write-Host &amp;quot;Hallo, $name!&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
Greet-Person &amp;quot;Anna&amp;quot;&lt;br /&gt;
Greet-Person -name &amp;quot;Bob&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# Mehrere Parameter&lt;br /&gt;
function Get-Rechteck {&lt;br /&gt;
    param(&lt;br /&gt;
        $breite,&lt;br /&gt;
        $hoehe&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    $flaeche = $breite * $hoehe&lt;br /&gt;
    $umfang = 2 * ($breite + $hoehe)&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Fläche: $flaeche&amp;quot;&lt;br /&gt;
    Write-Host &amp;quot;Umfang: $umfang&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
Get-Rechteck -breite 5 -hoehe 10&lt;br /&gt;
Get-Rechteck 5 10  # Positionsparameter&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Typisierte Parameter ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Add-Numbers {&lt;br /&gt;
    param(&lt;br /&gt;
        [int]$zahl1,&lt;br /&gt;
        [int]$zahl2&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    return $zahl1 + $zahl2&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
Add-Numbers 5 10          # 15&lt;br /&gt;
Add-Numbers &amp;quot;5&amp;quot; &amp;quot;10&amp;quot;      # 15 (automatische Konvertierung)&lt;br /&gt;
# Add-Numbers &amp;quot;abc&amp;quot; &amp;quot;xyz&amp;quot; # Fehler!&lt;br /&gt;
&lt;br /&gt;
# Verschiedene Typen&lt;br /&gt;
function New-User {&lt;br /&gt;
    param(&lt;br /&gt;
        [string]$name,&lt;br /&gt;
        [int]$alter,&lt;br /&gt;
        [bool]$aktiv,&lt;br /&gt;
        [datetime]$geburtsdatum,&lt;br /&gt;
        [array]$rollen&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Benutzer: $name, Alter: $alter, Aktiv: $aktiv&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Standardwerte ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Write-Log {&lt;br /&gt;
    param(&lt;br /&gt;
        [string]$nachricht,&lt;br /&gt;
        [string]$level = &amp;quot;INFO&amp;quot;,&lt;br /&gt;
        [string]$datei = &amp;quot;C:\Logs\app.log&amp;quot;&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    $zeitstempel = Get-Date -Format &amp;quot;yyyy-MM-dd HH:mm:ss&amp;quot;&lt;br /&gt;
    $eintrag = &amp;quot;[$zeitstempel] [$level] $nachricht&amp;quot;&lt;br /&gt;
    &lt;br /&gt;
    Add-Content -Path $datei -Value $eintrag&lt;br /&gt;
    Write-Host $eintrag&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Mit Standardwerten&lt;br /&gt;
Write-Log &amp;quot;Anwendung gestartet&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# Standardwerte überschreiben&lt;br /&gt;
Write-Log -nachricht &amp;quot;Kritischer Fehler&amp;quot; -level &amp;quot;ERROR&amp;quot;&lt;br /&gt;
Write-Log -nachricht &amp;quot;Debug-Info&amp;quot; -level &amp;quot;DEBUG&amp;quot; -datei &amp;quot;C:\Logs\debug.log&amp;quot;&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Mandatory Parameter ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Connect-Server {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [string]$servername,&lt;br /&gt;
        &lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [string]$username,&lt;br /&gt;
        &lt;br /&gt;
        [Parameter(Mandatory=$false)]&lt;br /&gt;
        [string]$port = &amp;quot;22&amp;quot;&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Verbinde zu $servername`:$port als $username...&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# PowerShell fragt nach fehlenden Parametern&lt;br /&gt;
Connect-Server&lt;br /&gt;
# Cmdlet Connect-Server an Befehlspipelineposition 1&lt;br /&gt;
# Geben Sie Werte für die folgenden Parameter an:&lt;br /&gt;
# servername: ...&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
== Modul 5.3: Parameter-Validierung ==&lt;br /&gt;
&lt;br /&gt;
=== ValidateSet ===&lt;br /&gt;
&lt;br /&gt;
Beschränkt Eingaben auf eine Liste erlaubter Werte:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Set-LogLevel {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [ValidateSet(&amp;quot;DEBUG&amp;quot;, &amp;quot;INFO&amp;quot;, &amp;quot;WARNING&amp;quot;, &amp;quot;ERROR&amp;quot;, &amp;quot;CRITICAL&amp;quot;)]&lt;br /&gt;
        [string]$level&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Log-Level gesetzt auf: $level&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
Set-LogLevel -level &amp;quot;INFO&amp;quot;     # OK&lt;br /&gt;
Set-LogLevel -level &amp;quot;TRACE&amp;quot;    # Fehler!&lt;br /&gt;
&lt;br /&gt;
# Mit Tab-Completion&lt;br /&gt;
Set-LogLevel -level &amp;lt;Tab&amp;gt;  # Zeigt Optionen&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== ValidateRange ===&lt;br /&gt;
&lt;br /&gt;
Prüft, ob Zahlen in einem Bereich liegen:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Set-Volume {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [ValidateRange(0, 100)]&lt;br /&gt;
        [int]$lautstaerke&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Lautstärke auf $lautstaerke% gesetzt&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
Set-Volume -lautstaerke 50   # OK&lt;br /&gt;
Set-Volume -lautstaerke 150  # Fehler!&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== ValidateLength ===&lt;br /&gt;
&lt;br /&gt;
Prüft String-Länge:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function New-Username {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [ValidateLength(3, 20)]&lt;br /&gt;
        [string]$username&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Benutzername erstellt: $username&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
New-Username -username &amp;quot;ab&amp;quot;           # Fehler (zu kurz)&lt;br /&gt;
New-Username -username &amp;quot;max123&amp;quot;       # OK&lt;br /&gt;
New-Username -username &amp;quot;a&amp;quot; * 25       # Fehler (zu lang)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== ValidatePattern ===&lt;br /&gt;
&lt;br /&gt;
Prüft gegen Regex-Muster:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Set-Email {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [ValidatePattern(&amp;quot;^\w+@\w+\.\w+$&amp;quot;)]&lt;br /&gt;
        [string]$email&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Email gesetzt: $email&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
Set-Email -email &amp;quot;user@example.com&amp;quot;  # OK&lt;br /&gt;
Set-Email -email &amp;quot;invalid-email&amp;quot;     # Fehler!&lt;br /&gt;
&lt;br /&gt;
# IP-Adresse validieren&lt;br /&gt;
function Test-IPAddress {&lt;br /&gt;
    param(&lt;br /&gt;
        [ValidatePattern(&amp;quot;^(\d{1,3}\.){3}\d{1,3}$&amp;quot;)]&lt;br /&gt;
        [string]$ip&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Gültige IP: $ip&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== ValidateScript ===&lt;br /&gt;
&lt;br /&gt;
Führt eigenen Validierungs-Code aus:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Remove-OldFile {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [ValidateScript({&lt;br /&gt;
            Test-Path $_ -PathType Leaf&lt;br /&gt;
        })]&lt;br /&gt;
        [string]$pfad&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Remove-Item -Path $pfad&lt;br /&gt;
    Write-Host &amp;quot;Datei gelöscht: $pfad&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Mit Fehlermeldung&lt;br /&gt;
function Set-Port {&lt;br /&gt;
    param(&lt;br /&gt;
        [ValidateScript({&lt;br /&gt;
            if ($_ -ge 1024 -and $_ -le 65535) {&lt;br /&gt;
                $true&lt;br /&gt;
            } else {&lt;br /&gt;
                throw &amp;quot;Port muss zwischen 1024 und 65535 liegen&amp;quot;&lt;br /&gt;
            }&lt;br /&gt;
        })]&lt;br /&gt;
        [int]$port&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Port gesetzt: $port&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== ValidateNotNullOrEmpty ===&lt;br /&gt;
&lt;br /&gt;
Stellt sicher, dass Parameter nicht leer ist:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function New-Folder {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [ValidateNotNullOrEmpty()]&lt;br /&gt;
        [string]$name&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    New-Item -Path $name -ItemType Directory&lt;br /&gt;
    Write-Host &amp;quot;Ordner erstellt: $name&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
New-Folder -name &amp;quot;&amp;quot;       # Fehler!&lt;br /&gt;
New-Folder -name $null    # Fehler!&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Mehrere Validierungen kombinieren ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function New-SecurePassword {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [ValidateNotNullOrEmpty()]&lt;br /&gt;
        [ValidateLength(8, 50)]&lt;br /&gt;
        [ValidatePattern(&amp;quot;^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)(?=.*[@$!%*?&amp;amp;])[A-Za-z\d@$!%*?&amp;amp;]+$&amp;quot;)]&lt;br /&gt;
        [string]$passwort&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Sicheres Passwort erstellt!&amp;quot; -ForegroundColor Green&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Muss alle Kriterien erfüllen:&lt;br /&gt;
# - Nicht leer&lt;br /&gt;
# - 8-50 Zeichen&lt;br /&gt;
# - Mind. 1 Kleinbuchstabe, 1 Großbuchstabe, 1 Zahl, 1 Sonderzeichen&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
{{Tipp|Parameter-Validierung hilft, Fehler frühzeitig zu erkennen und macht Funktionen robuster!}}&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
== Modul 5.4: Fortgeschrittene Parameter-Features ==&lt;br /&gt;
&lt;br /&gt;
=== Parameter-Sets ===&lt;br /&gt;
&lt;br /&gt;
Definiere verschiedene Parameter-Kombinationen:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Connect-Database {&lt;br /&gt;
    [CmdletBinding(DefaultParameterSetName=&amp;quot;Integrated&amp;quot;)]&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(ParameterSetName=&amp;quot;Integrated&amp;quot;, Mandatory=$true)]&lt;br /&gt;
        [Parameter(ParameterSetName=&amp;quot;SqlAuth&amp;quot;, Mandatory=$true)]&lt;br /&gt;
        [string]$server,&lt;br /&gt;
        &lt;br /&gt;
        [Parameter(ParameterSetName=&amp;quot;SqlAuth&amp;quot;, Mandatory=$true)]&lt;br /&gt;
        [string]$username,&lt;br /&gt;
        &lt;br /&gt;
        [Parameter(ParameterSetName=&amp;quot;SqlAuth&amp;quot;, Mandatory=$true)]&lt;br /&gt;
        [string]$password,&lt;br /&gt;
        &lt;br /&gt;
        [Parameter(ParameterSetName=&amp;quot;Integrated&amp;quot;)]&lt;br /&gt;
        [switch]$integratedSecurity = $true&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    if ($PSCmdlet.ParameterSetName -eq &amp;quot;Integrated&amp;quot;) {&lt;br /&gt;
        Write-Host &amp;quot;Verbinde mit integrierter Authentifizierung...&amp;quot;&lt;br /&gt;
    } else {&lt;br /&gt;
        Write-Host &amp;quot;Verbinde als $username...&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Verwendung&lt;br /&gt;
Connect-Database -server &amp;quot;SQL01&amp;quot;  # Integrated&lt;br /&gt;
Connect-Database -server &amp;quot;SQL01&amp;quot; -username &amp;quot;admin&amp;quot; -password &amp;quot;geheim&amp;quot;  # SqlAuth&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Pipeline-Input ===&lt;br /&gt;
&lt;br /&gt;
Funktionen können Werte aus der Pipeline empfangen:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Convert-ToMB {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(ValueFromPipeline=$true)]&lt;br /&gt;
        [long]$bytes&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    process {&lt;br /&gt;
        $mb = [math]::Round($bytes / 1MB, 2)&lt;br /&gt;
        Write-Host &amp;quot;$bytes Bytes = $mb MB&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Aus Pipeline&lt;br /&gt;
Get-ChildItem | Select-Object -First 5 Length | Convert-ToMB&lt;br /&gt;
&lt;br /&gt;
# Direkter Aufruf&lt;br /&gt;
Convert-ToMB -bytes 52428800&lt;br /&gt;
&lt;br /&gt;
# Pipeline mit Objekteigenschaften&lt;br /&gt;
function Get-ProcessMemory {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(ValueFromPipelineByPropertyName=$true)]&lt;br /&gt;
        [string]$Name&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    process {&lt;br /&gt;
        $prozess = Get-Process -Name $Name -ErrorAction SilentlyContinue&lt;br /&gt;
        if ($prozess) {&lt;br /&gt;
            $memMB = [math]::Round($prozess.WorkingSet / 1MB, 2)&lt;br /&gt;
            Write-Host &amp;quot;$Name : $memMB MB&amp;quot;&lt;br /&gt;
        }&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Verwendung&lt;br /&gt;
Get-Process | Select-Object -First 5 Name | Get-ProcessMemory&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Begin, Process, End ===&lt;br /&gt;
&lt;br /&gt;
Für Pipeline-Verarbeitung:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Convert-Text {&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(ValueFromPipeline=$true)]&lt;br /&gt;
        [string]$text&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    begin {&lt;br /&gt;
        Write-Host &amp;quot;=== Konvertierung starten ===&amp;quot;&lt;br /&gt;
        $anzahl = 0&lt;br /&gt;
    }&lt;br /&gt;
    &lt;br /&gt;
    process {&lt;br /&gt;
        $anzahl++&lt;br /&gt;
        $gross = $text.ToUpper()&lt;br /&gt;
        Write-Host &amp;quot;$anzahl. $gross&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
    &lt;br /&gt;
    end {&lt;br /&gt;
        Write-Host &amp;quot;=== $anzahl Texte konvertiert ===&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Verwendung&lt;br /&gt;
&amp;quot;anna&amp;quot;, &amp;quot;bob&amp;quot;, &amp;quot;clara&amp;quot; | Convert-Text&lt;br /&gt;
&lt;br /&gt;
# Ausgabe:&lt;br /&gt;
# === Konvertierung starten ===&lt;br /&gt;
# 1. ANNA&lt;br /&gt;
# 2. BOB&lt;br /&gt;
# 3. CLARA&lt;br /&gt;
# === 3 Texte konvertiert ===&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Switch-Parameter ===&lt;br /&gt;
&lt;br /&gt;
Boolean-Parameter ohne Wert:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Get-Files {&lt;br /&gt;
    param(&lt;br /&gt;
        [string]$path = &amp;quot;.&amp;quot;,&lt;br /&gt;
        [switch]$recurse,&lt;br /&gt;
        [switch]$hidden&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    $params = @{&lt;br /&gt;
        Path = $path&lt;br /&gt;
    }&lt;br /&gt;
    &lt;br /&gt;
    if ($recurse) {&lt;br /&gt;
        $params.Recurse = $true&lt;br /&gt;
    }&lt;br /&gt;
    &lt;br /&gt;
    if ($hidden) {&lt;br /&gt;
        $params.Force = $true&lt;br /&gt;
    }&lt;br /&gt;
    &lt;br /&gt;
    Get-ChildItem @params&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Verwendung&lt;br /&gt;
Get-Files&lt;br /&gt;
Get-Files -recurse&lt;br /&gt;
Get-Files -path &amp;quot;C:\Temp&amp;quot; -recurse -hidden&lt;br /&gt;
&lt;br /&gt;
# Switch-Wert abfragen&lt;br /&gt;
if ($recurse) {&lt;br /&gt;
    Write-Host &amp;quot;Rekursive Suche aktiviert&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
== Modul 5.5: [CmdletBinding] und fortgeschrittene Funktionen ==&lt;br /&gt;
&lt;br /&gt;
=== Was ist [CmdletBinding]? ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;code&amp;gt;[CmdletBinding()]&amp;lt;/code&amp;gt; macht aus einer einfachen Funktion eine &amp;#039;&amp;#039;&amp;#039;Advanced Function&amp;#039;&amp;#039;&amp;#039; mit Cmdlet-Features:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Get-AdvancedInfo {&lt;br /&gt;
    [CmdletBinding()]&lt;br /&gt;
    param(&lt;br /&gt;
        [string]$name&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Verbose &amp;quot;Rufe Informationen für $name ab...&amp;quot;&lt;br /&gt;
    Write-Host &amp;quot;Info für: $name&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Aktiviert automatisch:&lt;br /&gt;
# -Verbose&lt;br /&gt;
# -Debug&lt;br /&gt;
# -ErrorAction&lt;br /&gt;
# -WarningAction&lt;br /&gt;
# -InformationAction&lt;br /&gt;
# -ErrorVariable&lt;br /&gt;
# -WarningVariable&lt;br /&gt;
# -OutVariable&lt;br /&gt;
# -OutBuffer&lt;br /&gt;
# -PipelineVariable&lt;br /&gt;
&lt;br /&gt;
Get-AdvancedInfo -name &amp;quot;Test&amp;quot; -Verbose&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Common Parameters ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Test-AdvancedFunction {&lt;br /&gt;
    [CmdletBinding()]&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [string]$name&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    Write-Verbose &amp;quot;Verbose-Nachricht: Starte Verarbeitung&amp;quot;&lt;br /&gt;
    Write-Debug &amp;quot;Debug-Nachricht: Name = $name&amp;quot;&lt;br /&gt;
    Write-Warning &amp;quot;Warnung: Dies ist ein Test&amp;quot;&lt;br /&gt;
    Write-Information &amp;quot;Info-Nachricht&amp;quot;&lt;br /&gt;
    &lt;br /&gt;
    Write-Host &amp;quot;Verarbeite: $name&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Verwendung&lt;br /&gt;
Test-AdvancedFunction -name &amp;quot;Test&amp;quot; -Verbose&lt;br /&gt;
Test-AdvancedFunction -name &amp;quot;Test&amp;quot; -Debug&lt;br /&gt;
Test-AdvancedFunction -name &amp;quot;Test&amp;quot; -WarningAction SilentlyContinue&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== SupportsShouldProcess ===&lt;br /&gt;
&lt;br /&gt;
Ermöglicht -WhatIf und -Confirm:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Remove-CustomFile {&lt;br /&gt;
    [CmdletBinding(SupportsShouldProcess=$true)]&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [string]$path&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    if ($PSCmdlet.ShouldProcess($path, &amp;quot;Datei löschen&amp;quot;)) {&lt;br /&gt;
        Remove-Item -Path $path&lt;br /&gt;
        Write-Host &amp;quot;Datei gelöscht: $path&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Verwendung&lt;br /&gt;
Remove-CustomFile -path &amp;quot;test.txt&amp;quot; -WhatIf    # Zeigt nur, was passieren würde&lt;br /&gt;
Remove-CustomFile -path &amp;quot;test.txt&amp;quot; -Confirm   # Fragt nach Bestätigung&lt;br /&gt;
Remove-CustomFile -path &amp;quot;test.txt&amp;quot;            # Führt aus&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== ConfirmImpact ===&lt;br /&gt;
&lt;br /&gt;
Bestimmt, wann automatisch nach Bestätigung gefragt wird:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Remove-ImportantFile {&lt;br /&gt;
    [CmdletBinding(&lt;br /&gt;
        SupportsShouldProcess=$true,&lt;br /&gt;
        ConfirmImpact=&amp;quot;High&amp;quot;&lt;br /&gt;
    )]&lt;br /&gt;
    param(&lt;br /&gt;
        [string]$path&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    if ($PSCmdlet.ShouldProcess($path, &amp;quot;Wichtige Datei löschen&amp;quot;)) {&lt;br /&gt;
        Remove-Item -Path $path -Force&lt;br /&gt;
        Write-Host &amp;quot;Datei gelöscht&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Bei ConfirmImpact=&amp;quot;High&amp;quot; wird automatisch um Bestätigung gebeten&lt;br /&gt;
# (außer $ConfirmPreference wurde geändert)&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
== Modul 5.6: Skripte erstellen ==&lt;br /&gt;
&lt;br /&gt;
=== Skript vs. Funktion ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Aspekt !! Funktion !! Skript&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Definition&amp;#039;&amp;#039;&amp;#039; || Im Speicher || Als .ps1-Datei&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Aufruf&amp;#039;&amp;#039;&amp;#039; || Nach Name || Mit Pfad&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Lebensdauer&amp;#039;&amp;#039;&amp;#039; || Session || Datei bleibt&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Parameter&amp;#039;&amp;#039;&amp;#039; || param-Block || param-Block&lt;br /&gt;
|-&lt;br /&gt;
| &amp;#039;&amp;#039;&amp;#039;Verwendung&amp;#039;&amp;#039;&amp;#039; || Wiederverwendbare Bausteine || Komplette Programme&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
=== Einfaches Skript ===&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Datei: Backup.ps1&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
# Backup-Skript&lt;br /&gt;
param(&lt;br /&gt;
    [string]$quelle = &amp;quot;C:\Daten&amp;quot;,&lt;br /&gt;
    [string]$ziel = &amp;quot;D:\Backup&amp;quot;&lt;br /&gt;
)&lt;br /&gt;
&lt;br /&gt;
Write-Host &amp;quot;=== Backup-Skript ===&amp;quot;&lt;br /&gt;
Write-Host &amp;quot;Quelle: $quelle&amp;quot;&lt;br /&gt;
Write-Host &amp;quot;Ziel: $ziel&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# Prüfen ob Quelle existiert&lt;br /&gt;
if (-not (Test-Path $quelle)) {&lt;br /&gt;
    Write-Host &amp;quot;Fehler: Quelle existiert nicht!&amp;quot; -ForegroundColor Red&lt;br /&gt;
    exit 1&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Zielordner erstellen&lt;br /&gt;
if (-not (Test-Path $ziel)) {&lt;br /&gt;
    New-Item -Path $ziel -ItemType Directory | Out-Null&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Backup durchführen&lt;br /&gt;
$datum = Get-Date -Format &amp;quot;yyyy-MM-dd_HHmmss&amp;quot;&lt;br /&gt;
$backupOrdner = Join-Path $ziel &amp;quot;Backup_$datum&amp;quot;&lt;br /&gt;
&lt;br /&gt;
Copy-Item -Path $quelle -Destination $backupOrdner -Recurse&lt;br /&gt;
&lt;br /&gt;
Write-Host &amp;quot;Backup abgeschlossen: $backupOrdner&amp;quot; -ForegroundColor Green&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Ausführen:&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
# Im aktuellen Verzeichnis&lt;br /&gt;
.\Backup.ps1&lt;br /&gt;
&lt;br /&gt;
# Mit Parametern&lt;br /&gt;
.\Backup.ps1 -quelle &amp;quot;C:\Dokumente&amp;quot; -ziel &amp;quot;E:\Backups&amp;quot;&lt;br /&gt;
&lt;br /&gt;
# Mit vollständigem Pfad&lt;br /&gt;
C:\Scripts\Backup.ps1&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Skript-Parameter ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
# SystemInfo.ps1&lt;br /&gt;
[CmdletBinding()]&lt;br /&gt;
param(&lt;br /&gt;
    [Parameter(Mandatory=$false)]&lt;br /&gt;
    [string[]]$computerName = $env:COMPUTERNAME,&lt;br /&gt;
    &lt;br /&gt;
    [Parameter(Mandatory=$false)]&lt;br /&gt;
    [switch]$exportieren,&lt;br /&gt;
    &lt;br /&gt;
    [Parameter(Mandatory=$false)]&lt;br /&gt;
    [string]$exportPfad = &amp;quot;.\system_info.csv&amp;quot;&lt;br /&gt;
)&lt;br /&gt;
&lt;br /&gt;
$ergebnisse = @()&lt;br /&gt;
&lt;br /&gt;
foreach ($computer in $computerName) {&lt;br /&gt;
    Write-Verbose &amp;quot;Sammle Informationen von $computer...&amp;quot;&lt;br /&gt;
    &lt;br /&gt;
    try {&lt;br /&gt;
        $os = Get-CimInstance -ClassName Win32_OperatingSystem -ComputerName $computer&lt;br /&gt;
        $cs = Get-CimInstance -ClassName Win32_ComputerSystem -ComputerName $computer&lt;br /&gt;
        &lt;br /&gt;
        $info = [PSCustomObject]@{&lt;br /&gt;
            Computer = $computer&lt;br /&gt;
            OS = $os.Caption&lt;br /&gt;
            Version = $os.Version&lt;br /&gt;
            LastBoot = $os.LastBootUpTime&lt;br /&gt;
            TotalRAM_GB = [math]::Round($cs.TotalPhysicalMemory / 1GB, 2)&lt;br /&gt;
            Manufacturer = $cs.Manufacturer&lt;br /&gt;
            Model = $cs.Model&lt;br /&gt;
        }&lt;br /&gt;
        &lt;br /&gt;
        $ergebnisse += $info&lt;br /&gt;
        $info | Format-List&lt;br /&gt;
        &lt;br /&gt;
    } catch {&lt;br /&gt;
        Write-Warning &amp;quot;Fehler bei $computer : $_&amp;quot;&lt;br /&gt;
    }&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
if ($exportieren) {&lt;br /&gt;
    $ergebnisse | Export-Csv -Path $exportPfad -NoTypeInformation&lt;br /&gt;
    Write-Host &amp;quot;`nExportiert nach: $exportPfad&amp;quot; -ForegroundColor Green&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Exit-Codes ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
# TestScript.ps1&lt;br /&gt;
param(&lt;br /&gt;
    [string]$pfad&lt;br /&gt;
)&lt;br /&gt;
&lt;br /&gt;
if (-not (Test-Path $pfad)) {&lt;br /&gt;
    Write-Host &amp;quot;Fehler: Pfad nicht gefunden!&amp;quot; -ForegroundColor Red&lt;br /&gt;
    exit 1  # Fehler-Code&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
if ((Get-Item $pfad).Length -eq 0) {&lt;br /&gt;
    Write-Host &amp;quot;Warnung: Datei ist leer!&amp;quot; -ForegroundColor Yellow&lt;br /&gt;
    exit 2  # Warnung-Code&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
Write-Host &amp;quot;Alles OK!&amp;quot; -ForegroundColor Green&lt;br /&gt;
exit 0  # Erfolg&lt;br /&gt;
&lt;br /&gt;
# Exit-Code abfragen:&lt;br /&gt;
# .\TestScript.ps1 -pfad &amp;quot;test.txt&amp;quot;&lt;br /&gt;
# $LASTEXITCODE  # Zeigt Exit-Code&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
== Modul 5.7: Kommentare und Dokumentation ==&lt;br /&gt;
&lt;br /&gt;
=== Einzeilige Kommentare ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
# Dies ist ein einzeiliger Kommentar&lt;br /&gt;
&lt;br /&gt;
$name = &amp;quot;Anna&amp;quot;  # Kommentar am Zeilenende&lt;br /&gt;
&lt;br /&gt;
# Mehrere&lt;br /&gt;
# aufeinanderfolgende&lt;br /&gt;
# Kommentare&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Mehrzeilige Kommentare ===&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;#&lt;br /&gt;
Dies ist ein mehrzeiliger Kommentar.&lt;br /&gt;
Er kann über mehrere Zeilen gehen.&lt;br /&gt;
Nützlich für längere Erklärungen.&lt;br /&gt;
#&amp;gt;&lt;br /&gt;
&lt;br /&gt;
function Get-Data {&lt;br /&gt;
    &amp;lt;#&lt;br /&gt;
    Hier kann die Funktions-Dokumentation stehen.&lt;br /&gt;
    Beschreibung der Funktion...&lt;br /&gt;
    #&amp;gt;&lt;br /&gt;
    &lt;br /&gt;
    # Code hier&lt;br /&gt;
}&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Comment-Based Help ===&lt;br /&gt;
&lt;br /&gt;
Professionelle Dokumentation mit Get-Help:&lt;br /&gt;
&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Get-UserReport {&lt;br /&gt;
    &amp;lt;#&lt;br /&gt;
    .SYNOPSIS&lt;br /&gt;
        Erstellt einen Bericht über Benutzer.&lt;br /&gt;
    &lt;br /&gt;
    .DESCRIPTION&lt;br /&gt;
        Diese Funktion sammelt Informationen über Benutzer&lt;br /&gt;
        und erstellt einen detaillierten Bericht.&lt;br /&gt;
        Der Bericht kann in verschiedenen Formaten exportiert werden.&lt;br /&gt;
    &lt;br /&gt;
    .PARAMETER username&lt;br /&gt;
        Der Benutzername für den Bericht.&lt;br /&gt;
    &lt;br /&gt;
    .PARAMETER format&lt;br /&gt;
        Das Export-Format (CSV, JSON, HTML).&lt;br /&gt;
        Standard ist CSV.&lt;br /&gt;
    &lt;br /&gt;
    .PARAMETER outputPath&lt;br /&gt;
        Der Pfad für die Export-Datei.&lt;br /&gt;
        Standard ist das aktuelle Verzeichnis.&lt;br /&gt;
    &lt;br /&gt;
    .EXAMPLE&lt;br /&gt;
        Get-UserReport -username &amp;quot;anna&amp;quot;&lt;br /&gt;
        Erstellt einen Bericht für Benutzer anna.&lt;br /&gt;
    &lt;br /&gt;
    .EXAMPLE&lt;br /&gt;
        Get-UserReport -username &amp;quot;bob&amp;quot; -format &amp;quot;JSON&amp;quot; -outputPath &amp;quot;C:\Reports&amp;quot;&lt;br /&gt;
        Erstellt einen JSON-Bericht für bob im angegebenen Pfad.&lt;br /&gt;
    &lt;br /&gt;
    .NOTES&lt;br /&gt;
        Author: Max Mustermann&lt;br /&gt;
        Version: 1.0&lt;br /&gt;
        LastModified: 2025-01-15&lt;br /&gt;
    &lt;br /&gt;
    .LINK&lt;br /&gt;
        https://docs.example.com/get-userreport&lt;br /&gt;
    #&amp;gt;&lt;br /&gt;
    &lt;br /&gt;
    [CmdletBinding()]&lt;br /&gt;
    param(&lt;br /&gt;
        [Parameter(Mandatory=$true)]&lt;br /&gt;
        [string]$username,&lt;br /&gt;
        &lt;br /&gt;
        [ValidateSet(&amp;quot;CSV&amp;quot;, &amp;quot;JSON&amp;quot;, &amp;quot;HTML&amp;quot;)]&lt;br /&gt;
        [string]$format = &amp;quot;CSV&amp;quot;,&lt;br /&gt;
        &lt;br /&gt;
        [string]$outputPath = &amp;quot;.&amp;quot;&lt;br /&gt;
    )&lt;br /&gt;
    &lt;br /&gt;
    # Funktions-Code hier&lt;br /&gt;
    Write-Host &amp;quot;Erstelle $format-Bericht für $username...&amp;quot;&lt;br /&gt;
}&lt;br /&gt;
&lt;br /&gt;
# Hilfe anzeigen&lt;br /&gt;
Get-Help Get-UserReport&lt;br /&gt;
Get-Help Get-UserReport -Detailed&lt;br /&gt;
Get-Help Get-UserReport -Examples&lt;br /&gt;
Get-Help Get-UserReport -Full&lt;br /&gt;
&amp;lt;/syntaxhighlight&amp;gt;&lt;br /&gt;
&lt;br /&gt;
=== Comment-Based Help Schlüsselwörter ===&lt;br /&gt;
&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Schlüsselwort !! Beschreibung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.SYNOPSIS&amp;lt;/code&amp;gt; || Kurze Beschreibung (eine Zeile)&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.DESCRIPTION&amp;lt;/code&amp;gt; || Detaillierte Beschreibung&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.PARAMETER&amp;lt;/code&amp;gt; || Beschreibung eines Parameters&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.EXAMPLE&amp;lt;/code&amp;gt; || Verwendungsbeispiel&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.INPUTS&amp;lt;/code&amp;gt; || Was kann über Pipeline empfangen werden&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.OUTPUTS&amp;lt;/code&amp;gt; || Was wird zurückgegeben&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.NOTES&amp;lt;/code&amp;gt; || Zusätzliche Informationen&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.LINK&amp;lt;/code&amp;gt; || Verweis auf Website/Dokument&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.COMPONENT&amp;lt;/code&amp;gt; || Technologie/Feature&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.ROLE&amp;lt;/code&amp;gt; || Zielrolle&lt;br /&gt;
|-&lt;br /&gt;
| &amp;lt;code&amp;gt;.FUNCTIONALITY&amp;lt;/code&amp;gt; || Funktionalität&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
----&lt;br /&gt;
&lt;br /&gt;
== Praktische Übungen ==&lt;br /&gt;
&lt;br /&gt;
=== Übung 1: Temperatur-Konverter ===&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Aufgabe:&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
Erstelle eine Funktion, die:&lt;br /&gt;
# Celsius in Fahrenheit und Kelvin konvertiert&lt;br /&gt;
# Parameter für die Eingabe-Temperatur hat&lt;br /&gt;
# Parameter-Validierung verwendet (-273.15°C ist absoluter Nullpunkt)&lt;br /&gt;
# Ein Objekt mit allen drei Werten zurückgibt&lt;br /&gt;
# Comment-Based Help hat&lt;br /&gt;
&lt;br /&gt;
&amp;lt;div class=&amp;quot;mw-collapsible mw-collapsed&amp;quot;&amp;gt;&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;Lösung anzeigen&amp;#039;&amp;#039;&amp;#039;&lt;br /&gt;
&amp;lt;div class=&amp;quot;mw-collapsible-content&amp;quot;&amp;gt;&lt;br /&gt;
&amp;lt;syntaxhighlight lang=&amp;quot;powershell&amp;quot;&amp;gt;&lt;br /&gt;
function Convert-Temperature {&lt;br /&gt;
    &amp;lt;#&lt;br /&gt;
    .SYNOPSIS&lt;br /&gt;
        Konvertiert Celsius in Fahrenheit und Kelvin.&lt;br /&gt;
    &lt;br /&gt;
    .DESCRIPTION&lt;br /&gt;
        Diese Funktion nimmt eine Temperatur in Celsius entgegen&lt;br /&gt;
        und konvertiert sie in Fahrenheit und Kelvin.&lt;br /&gt;
        Der absolute Nullpunkt (-273.15°C) ist die Untergrenze.&lt;br /&gt;
    &lt;br /&gt;
    .PARAMETER celsius&lt;br /&gt;
        Die Temperatur in Grad Celsius.&lt;br /&gt;
    &lt;br /&gt;
    .EXAMPLE&lt;br /&gt;
        Convert-Temperature -celsius 25&lt;br /&gt;
        Konvertiert 25°C in Fahrenheit und Kelvin.&lt;br /&gt;
    &lt;br /&gt;
    .EXAMPLE&lt;br /&gt;
        Convert-Temperature 0&lt;/div&gt;</summary>
		<author><name>Gerhard</name></author>
	</entry>
</feed>