about_Return

应用到: Windows PowerShell 2.0, Windows PowerShell 3.0, Windows PowerShell 4.0

主题

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 不会返回任何值。

          $a
          return

以下语句还在此处返回 $a:Insert 部分正文的值。

          return $a

以下示例包含一个语句，该语句旨在让用户知道函数正在执行计算：

          function calculation {
              param ($value)

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

运行此函数并将结果分配给一个变量会产生以下影响：

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

“请稍等。正在处理计算...”字符串不显示。相反，它将分配给 $a 变量，如以下示例所示：

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

信息性字符串和计算的结果由函数返回并分配给 $a 变量。

另请参阅

about_Language_Keywords 中的 Exit 关键字

about_Functions

about_Scopes

about_Script_Blocks