Beendet den aktuellen Bereich. Dies kann eine Funktion, ein (about_Return)

   

# THEMA
about_Return

# KURZBESCHREIBUNG
Beendet den aktuellen Bereich. Dies kann eine Funktion, ein
Skript oder ein Skriptblock sein.

# DETAILBESCHREIBUNG
Das Schlüsselwort "Return" beendet eine Funktion, ein Skript oder
einen Skriptblock. Es kann verwendet werden, um einen Bereich an einem
bestimmten Punkt zu beenden, einen Wert zurückzugeben oder um
anzugeben, dass das Ende des Bereichs erreicht wurde.

Benutzer, die auch mit anderen Sprachen wie C oder C# arbeiten,
sind es gewohnt, das Schlüsselwort "Return" jedes Mal für die
explizite Beendigung eines Bereichs zu verwenden.

In Windows PowerShell werden die Ergebnisse jeder Anweisung immer als
Ausgabe zurückgegeben, auch wenn keine abschließende Return-Anweisung
folgt. Sprachen wie C oder C# geben nur den Wert bzw. die Werte
zurück, die im Schlüsselwort "Return" angegeben sind.

Syntax

Die Syntax für das Schlüsselwort "Return" lautet wie folgt:

return [<Ausdruck>]

Das Schlüsselwort "Return" kann allein stehen oder gefolgt von
einem Wert oder Ausdruck geschrieben werden:

return
return $a
return (2 + $a)

Beispiele

Im folgenden Beispiel wird eine Funktion mit dem Schlüsselwort
"Return" an einem bestimmten Punkt beendet, falls die
angegebene Bedingung erfüllt ist:

function ScreenPassword($instance)
{
if (!($instance.screensaversecure)) {return $instance.name}
<additional statements>
}

foreach ($a in @(get-wmiobject win32_desktop)) {
ScreenPassword($a) }

Dieses Skript überprüft alle Benutzerkonten. Die Funktion
"ScreenPassword" gibt den Namen jedes Benutzerkontos zurück,
das keinen kennwortgeschützten Bildschirmschoner hat. Wenn der
Bildschirmschoner kennwortgeschützt ist, führt die Funktion alle
nachfolgenden Anweisungen aus, und Windows PowerShell gibt keinen
Wert zurück.

In Windows PowerShell können Werte auch dann zurückgegeben
werden, wenn das Schlüsselwort "Return" nicht verwendet wird. Die
Ergebnisse jeder Anweisung werden zurückgegeben. Die folgenden
Anweisungen geben z. B. den Wert der Variablen "$a" zurück:

$a
return

Die folgende Anweisung gibt ebenfalls den Wert von "$a" zurück:

return $a

Das folgende Beispiel beinhaltet eine Anweisung, die den
Benutzer darauf hinweist, dass die Funktion gerade eine Berechnung
durchführt:

function calculation {
param ($value)

"Bitte warten. Berechnung wird durchgeführt..."
$value += 73
return $value
}

Wenn diese Funktion ausgeführt und das Ergebnis einer Variablen
zugewiesen wird, führt dies zu folgendem Ergebnis:

C:\PS> $a = calculation 14
C:\PS>

Die Zeichenfolge "Bitte warten. Berechnung wird durchgeführt..."
wird nicht angezeigt. Stattdessen wird sie der Variablen "$a"
zugewiesen, wie im Folgenden gezeigt:

C:\PS> $a
Bitte warten. Berechnung wird durchgeführt...
87

Sowohl die Informationszeichenfolge als auch das Ergebnis der
Berechnung werden von der Funktion zurückgegeben und der
Variablen "$a" zugewiesen.

SIEHE AUCH
about_Functions
about_Scopes
about_Script_Blocks

C:\Windows>powershell get-help about_scopes -full

ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.