about_Return

主题
    about_Return

简短说明
    退出当前作用域（可能是函数、脚本或脚本块）。


详细说明
    Return 关键字用于退出函数、脚本或脚本块。它可用于在某个特定点退出作用域、返回一个值或指示
    已到达作用域结尾。


    熟悉 C 或 C# 等语言的用户可能希望使用 Return 关键字使退出作用域的逻辑变得明确。
 

    在 Windows PowerShell 中，每个语句的结果将作为输出返回，即使在没有包含 Return 关键字
    的语句的情况下也是如此。C 或 C# 等语言只返回 Return 关键字指定的一个或多个值。


  语法

      Return 关键字的语法如下：

          return [<expression>]


      Return 关键字既可以单独出现，也可以在后面跟一个值或表达式，例如：

          return
          return $a
          return (2 + $a)


  示例

      下面的示例使用 Return 关键字在满足某个条件的情况下在某个特定点退出函数：

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

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


      此脚本检查每个用户帐户。ScreenPassword 函数返回不具有受密码保护的屏幕保护程序的所有用
      户帐户的名称。如果屏幕保护程序受密码保护，则该函数会完成要运行的所有其他语句，而且 
      Windows PowerShell 不会返回任何值。


      在 Windows PowerShell 中，即使没有使用 Return 关键字，也可以返回值。每个语句的结果
      会被返回。例如，以下语句返回 $a 变量的值：

          $a
          return


      以下语句也返回 $a 的值：

          return $a


      下面的示例包括一个语句，其目的是让用户知道函数正在执行计算：

          function calculation {
              param ($value)

              "Please wait. Working on calculation..."
              $value += 73
              return $value
              }


      运行此函数并将结果赋给变量会产生以下效果：

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


      "Please wait. Working on calculation..."字符串不会显示。相反，该字符串会被赋给 
      $a 变量，如下面的示例中所示：

          C:\PS> $a
          Please wait. Working on calculation...
          87


      该函数会返回信息字符串和计算结果，并将其赋给 $a 变量。


另请参阅
    about_Functions
    about_Scopes
    about_Script_Blocks