Funktion Parameter Teil 1

Posted on: 11. September 2018
In mehreren Videos werden wir uns mit dem Thema der eigenen Funktion bzw. Cmdlet beschäftigen und ebenfalls vieles über die Parameter einer Funktion anschauen. Diese Videoserie ist eher umfangreicher, da das Thema auch sehr komplex ist. Trotzdem versuche ich auf verdauliche und ruhige Art klein anzufangen und dann immer umfangreicher zu werden.

Hier der Code aus dem Youtube-Video. Die Vorgehensweise und Bemerkungen findest du direkt als Kommentare (#Grün) im Code. So wird er dir ebenfalls in der PowerSHELL ISE angezeigt werden.
——————————————–
function Schreibe-MeineAusgabe {            
<# .Synopsis Kurzbeschrieb meiner Funkton .DESCRIPTION Etwas grössere und umfangreichere Beschreibung was meine Funktion macht und wozu sie eingesetzt werden kann. .EXAMPLE Beispiel 1 Meine-Funktion -Parameter1 "Hallo" .EXAMPLE Beispiel 2 Meine-Funtion -Parameter2 "Welt" .INPUTS [String]$Parameter1 hier wird Parameter 1 erklärt und beschrieben [String]$Parameter2 hier wird Parameter 2 erklärt und beschrieben .OUTPUTS [Array],[XML],[VOID], usw. was halt die Funktion alles zurück gibt .NOTES Hier kann ich noch einige Notizen zu der Funktion schreiben .COMPONENT Auf welche Komponenten (z.B. WMI) sich diese Funktion bezieht .ROLE Auf welche Server-Rolle sich diese Funkton bezieht z.B. ActiveDirectory, Hyper-V usw. .FUNCTIONALITY Die Funktionalität welche diese Funktion bzw. dieses Cmdlet erfüllt oder wofür es gedacht ist. #>            
[CmdletBinding(SupportsShouldProcess=$true,# Stellt die wichtigsten Standard-Parameter zur Verfügung z.B. ErrorAction usw.            
HelpUri = 'https://www.germanpowershell.com', # Kann über die get-help  -Online Funktion eine Webseite mit Hilfe aufrufen            
ConfirmImpact='Medium' # Bestätigungen (Confirm) werden nur bei mittleren (Medium) und grossen (High) Veränderungen abgefragt            
)]            
            
# Hier leiten wir die Parameter ein            
Param(            
            
# Erster Paramter vom Typ [Int] mit dem Namen "Eingabe"            
[Int]$Eingabe            
)            
            
# Eine versteckte/ausführliche Information die nur zusammen mit -Verbose ausgegeben wrid            
Write-Verbose "Das ist geheim"            
            
# Ausgabe des Parameters "Eingabe" auf der Standard-Ausgabe (Konsole)            
$Eingabe            
}
——————————————–
Solltest du irgendwelche Fragen haben, dann kannst du diese gerne entweder hier im Blog oder direkt unter dem YouTube Video stellen. Ich gebe alles, deine Fragen zeitnahe zu beantworten oder ein entsprechendes Video darüber zu machen.
Gerade die Grundlagen-Videos werde ich nicht mit viel Text ausschmücken. Bei mir ist jeweils jede Code-Zeile direkt im Code Kommentiert (#Grün). Du kannst den Code direkt mit in dein Script kopieren und hast so eine gute Orientierungshilfe, sobald du die Scripts auf deine Bedürfnisse anpasst.

Ich erstelle und veröffentliche sämtliche Videos kostenlos und blende auch keine Werbung ein, dies will ich auch so beibehalten. Da das vermittelte Wissen aber in teuren Kursen erlangt werden kann, ist eine kleine Spende hin und wieder sicher keine schlechte Gegenleistung.