esta es una orueb

TEMA
about_Functions

DESCRIPCIÓN BREVE
Describe cómo crear y utilizar las funciones en Windows PowerShell.


DESCRIPCIÓN DETALLADA
Una función es una lista de instrucciones que tiene el nombre que
se le asigna. Cuando se ejecuta una función, se escribe su nombre. Las
instrucciones de la lista se ejecutan como si las hubiera escrito en
el símbolo delsistema.

Al igual que los cmdlets, las funciones pueden tener parámetros.
Los parámetros pueden ser con nombre, posicionales, de
modificador o dinámicos. Los parámetros de función se pueden leer
desde la línea de comandos o desde la canalización.

Las funciones pueden devolver valores que se pueden mostrar,
asignar a variables o pasar a otras funciones o a cmdlets.La lista de instrucciones de la función puede contener tipos
diferentes de listas de instrucciones con las palabras clave
Begin, Process y End. Estas listas de instrucciones controlan de
manera diferente las entradas procedentes de la canalización.

Un filtro es un tipo especial de función que utiliza la palabra
clave Filter.

Las funciones tambiénpueden comportarse como cmdlets. Se puede
crear una función que funcione exactamente igual que un cmdlet
sin utilizar la programación en C#. Para obtener más información, vea
about_Functions_Advanced.


Sintaxis
A continuación se muestra la sintaxis de una función:

function [] [([tipo]$parámetro1[,[tipo]$par
ámetro2])]
{param([tipo]$parámetro1 [,[tipo]$parámetro2])

dynamicparam {}

begin {}
process {}
end {}
}


Una función incluye los elementos siguientes:

- Una palabra clave Function
- Un ámbito (opcional)
- Un nombre que se selecciona
- Cualquier cantidad de parámetros con nombre(opcionales)
- Uno o más comandos de Windows PowerShell agregados entre
llaves ({})


Para obtener más información sobre la palabra clave
Dynamicparam y los parámetros dinámicos en las funciones, vea
about_Functions_Advanced_Parameters.


Funciones simples
Las funciones no tienen que ser complicadas para resultar
útiles. Lafunción siguiente obtiene las variables de entorno que no
pertenecen a la cuenta System del sistema actual:

function other_env
{
get-wmiObject win32_environment |
where {$_.nombreusuario -ne ""}
}

Para ejecutar la función, escriba "other_env".

Se puede crear un cuadro de herramientas de funciones sencillasque resulten útiles. En about_Profiles y más adelante en este
tema se describe cómo agregar estas funciones al perfil de
Windows PowerShell.


Funciones con parámetros
Se pueden utilizar parámetros con las funciones, incluidos los
parámetros con nombre, posicionales, de modificador y
dinámicos. Para obtener más información sobre los parámetrosdinámicos en las funciones, vea about_Functions_Advanced_Parameters.


Parámetros con nombre
Es posible definir cualquier cantidad de parámetros con nombre.
Para los parámetros con nombre se puede incluir un valor
predeterminado, tal y como se describe más adelante en este tema.

Los parámetros se pueden definir entre llaves mediante la
palabraclave Param, como se muestra en la sintaxis de ejemplo
siguiente:

function {
param ([tipo]$parámetro1[,[tipo]$parámetro2])

}


También es posible definir los parámetros fuera de las llaves
sin utilizar la palabra clave Param, como se muestra en la
sintaxis de ejemplo siguiente:

function...