TEMA

about_Return
DESCRIPCIN BREVE
Produce la salida del mbito actual, que puede ser una funcin,
un script o un bloque de script.
DESCRIPCIN DETALLADA
La palabra clave Return produce la salida de una funcin, un
script o un bloque de script. Se puede utilizar para salir de un
mbito en un punto concreto, devolver un valor o indicar que se
ha alcanzado el final del mbito.
Quizs los usuarios familiarizados con lenguajes como C o C#
deseen utilizar la palabra clave Return para que la lgica de
salir de un mbito sea explcita.
En Windows PowerShell, los resultados de cada instruccin se
devuelven como salida, incluso si no hay ninguna instruccin que
contenga la palabra clave Return. Los lenguajes como C o C# devuelven
nicamente el valor o los valores especificados por la palabra clave
Return.
Sintaxis
La sintaxis de la palabra clave Return es la siguiente:
return [<expresin>]
La palabra clave Return puede aparecer sola o puede ir seguida
de un valor o una expresin, tal y como se indica a continuacin:
return
return $a
return (2 + $a)
Ejemplos
En el ejemplo siguiente, se utiliza la palabra clave Return
para salir de una funcin en un punto concreto si se cumple una
instruccin condicional:
function ScreenPassword($instance)
{
if (!($instance.screensaversecure)) {return $instance.name}
<instrucciones adicionales>
}
foreach ($a in @(get-wmiobject win32_desktop)) { ScreenPassword($a) }
Este script comprueba cada cuenta de usuario. La funcin
ScreenPassword devuelve el nombre de cualquier cuenta de
usuario que no tenga un protector de pantalla protegido mediante

contrasea. Si el protector de pantalla est protegido mediante

contrasea, la funcin completa cualquier otra instruccin que deba
ejecutarse y Windows PowerShell no devuelve ningn valor.
En Windows PowerShell, se devuelven valores incluso si no se
utiliza la palabra clave Return. Se devuelven los resultados de cada
instruccin. Por ejemplo, las instrucciones siguientes devuelven el
valor de la variable $a:
$a
return
La instruccin siguiente tambin devuelve el valor de $a:
return $a
El ejemplo siguiente incluye una instruccin para notificar al
usuario que la funcin est realizando un clculo:
function calculation {
param ($value)
"Espere. Se est realizando el clculo..."
$value += 73
return $value
}
Si se ejecuta esta funcin y se asigna el resultado a una
variable, el efecto ser el siguiente:
C:\PS> $a = calculation 14
C:\PS>
No se muestra la cadena "Espere. Se est realizando el
clculo...". En su lugar, se asigna la cadena a la variable $a,
como en el ejemplo siguiente:
C:\PS> $a
Espere. Se est realizando el clculo...
87
La funcin devuelve la cadena informativa y el resultado del
clculo, los cuales se asignan a la variable $a.
VEA TAMBIN
about_Functions
about_Scopes
about_Script_Blocks