about_Return - PowerShell Befehl Hilfe und Beispiele

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 

Microsoft Windows [Version 10.0.19045.3693]
Copyright (c) 2023 Microsoft Corporation.

ColorConsole [Version 3.7.1000] PowerShell 2.0-Export

Windows 11, 10, 8.1, 8, 7 / Server 2022, 2019, 2016