Verwenden von Funktionen

Funktionen sind ein Typ von Befehlen in Windows PowerShell. Eine Funktion führen Sie wie ein Cmdlet aus, indem Sie den jeweiligen Namen eingeben. Ähnlich wie Cmdlets können Funktionen Parameter aufweisen. Wie Cmdlets akzeptieren Funktionen .NET-Objekte als Eingabe und geben .NET-Objekte als Ausgabe zurück. Funktionen können Sie in der Tat fast genau wie Cmdlets verwenden.

Einen großen Vorteil von Funktionen bildet der Umstand, dass sie ganz einfach erstellt werden können. Im Gegensatz zu den in C# erstellten Cmdlets stellen Funktionen nur eine benannte Gruppe von Windows PowerShell-Befehlen und -Ausdrücken dar. Wenn Sie in Windows PowerShell Befehle eingeben können, können Sie auch Funktionen schreiben.

Funktionen sind Befehle, daher verwenden Sie zum Suchen von Funktionen das Cmdlet Get-Command.

Wenn Sie zum Beispiel alle Funktionen in einer Sitzung suchen möchten, geben Sie Folgendes ein:

get-command -CommandType function

Windows PowerShell unterstützt außerdem das Laufwerk "Function:", das alle Funktionen in der Sitzung enthält. Wenn Sie auf dem Laufwerk "Function:" navigieren möchten, verwenden Sie die gleichen Methoden wie zum Navigieren auf den Laufwerken des Dateisystems.

Um zum Funktionslaufwerk zu wechseln, geben Sie Folgendes ein:

cd function:

Um die Funktionen auf dem Funktionslaufwerk anzuzeigen, geben Sie Folgendes ein:

dir function:

Zum Ausführen einer Funktion geben Sie lediglich den Funktionsnamen ein. Wenn Sie beispielsweise die Funktion "Clear-Host" ausführen möchten, geben Sie Folgendes ein:

clear-host

An der Windows PowerShell-Konsole löschen Sie mit der Funktion "Clear-Host" den gesamten Text im Konsolenfenster. In anderen Hostprogrammen kann das Verhalten abweichen, oder es treten keine Auswirkungen ein.

Wenn Sie die Parameter einer Funktion verwenden möchten, geben Sie wie bei den Parametern eines Cmdlet den Parameternamen ein, und stellen Sie diesem einen Bindestrich voran und einen Wert nach.

Die Funktion "Help", mit der Sie Hilfethemen seitenweise anzeigen können, verfügt z. B. über die gleichen Parameter wie das Cmdlet "Get-Help". Wenn Sie mit der Funktion "Help" nur die Beispiele im Hilfethema zum Cmdlet "Get-Service" abrufen möchten, geben Sie Folgendes ein:

help -name get-service -examples

Funktionen können Hilfethemen zugeordnet sein. Zum Suchen des Hilfethemas für eine Funktion verwenden Sie das Cmdlet Get-Help. Mit diesem Cmdlet rufen Sie auch Hilfe zu Cmdlets ab.

Beispielsweise geben Sie Folgendes ein, um Hilfe für die Funktion "Disable-PSRemoting" abzurufen:

get-help Disable-PSRemoting

Hilfe für Funktionen können Sie mit allen Parametern des Cmdlet "Get-Help" aufrufen. Wenn Sie beispielsweise nur die Beispiele im Hilfethema zur Funktion "Disable-PSRemoting" abrufen möchten, geben Sie Folgendes ein:

get-help Disable-PSRemoting -example

Eine Funktion besteht aus einer benannten Gruppe von Befehlen oder Ausdrücken. Zum Erstellen einer einfachen Funktion verwenden Sie das folgende Format:

function <name> { <commands> }

Geben Sie einfach function und einen Namen für die Funktion ein, und schließen Sie die Befehle in geschweifte Klammern ({ }) ein.

Wenn Sie einen bestimmten Befehl immer wieder eingeben müssen, z. B. get-help get-member -examples, können Sie Zeit sparen, indem Sie eine Funktion erstellen, mit der dieser Befehl ausgeführt wird. Die folgende Funktion "GMEX" führt den Befehl aus.

function GMEX {get-help get-member -examples}

Wenn Sie die Funktion an der Windows PowerShell-Eingabeaufforderung eingegeben (oder aus diesem Thema kopiert und dort eingefügt) und dann EINGABETASTE gedrückt haben, können Sie die Funktion in der Sitzung verwenden. Zum Ausführen der Funktion geben Sie GMEX ein.

Dies ist eine einfache Funktion, doch mit nur einigen weiteren Zeilen können Sie Parameter hinzufügen, die Parameter als optional oder erforderlich festlegen sowie Benutzermeldungen und ein Hilfethema für die Funktion hinzufügen. Wenn Sie mehr über Windows PowerShell erfahren haben, können Sie erweiterte Funktionen mit allen Features von Cmdlets erstellen.

Weitere Informationen zum Erstellen von Funktionen finden Sie unter about_Functions, about_Comment_Based_Help und about_Functions_Advanced.

Wenn Sie Windows PowerShell öffnen, befinden Sie sich in einer Windows PowerShell-Sitzung. Die Sitzung dauert, bis Sie das Windows PowerShell-Fenster schließen oder Exit eingeben, um die Sitzung zu beenden. Sofern Sie Elemente nicht in einer Datei auf der Festplatte oder in der Registrierung speichern, werden die Elemente, die Sie in der Sitzung erstellen, beim Beenden der Sitzung gelöscht.

Wenn Sie die Funktionen, die Sie erstellen, speichern möchten, sodass sie in zukünftigen Windows PowerShell-Sitzungen verfügbar sind, erstellen Sie ein Windows PowerShell-Profil, und speichern Sie die Funktionen in diesem Profil.

Weitere Informationen finden Sie unter about_Profiles.