Function Provider

Cambia la ubicación actual a la unidad Function:. Puede usar este comando desde cualquier unidad de Windows PowerShell. Para volver a una unidad del sistema de archivos, escriba el nombre de la unidad. Por ejemplo, escriba "set-location c:".

set-location function:

Este comando obtiene la lista de todas las funciones de la sesión actual. Puede usar este comando desde cualquier unidad de Windows PowerShell.

get-childitem -path function:

Este comando obtiene la función "man" desde la unidad Function:. Usa el cmdlet Get-Item para obtener la función. El operador de canalización (|) envía el resultado a Format-Table.

El parámetro Wrap dirige a la siguiente línea el texto que no cabe en esta línea. El parámetro Autosize cambia el tamaño de las columnas de la tabla para dar cabida al texto.

get-item -path man | format-table -wrap -autosize

Si se encuentra en otra unidad, agregue el nombre de la unidad (Function:) a la ruta de acceso.

Estos dos comandos obtienen la función llamada "c:". El primer comando se puede usar en cualquier unidad, mientras que el segundo se usa en la unidad Function:.

Como el nombre termina en un signo de dos puntos, que es la sintaxis de una unidad, es necesario calificar la ruta de acceso con el nombre de unidad. En la unidad Function:, se puede usar cualquiera de los dos formatos. En el segundo comando, el punto (.) representa la ubicación actual.

c:\PS> get-item -path function:c:

PS Function> get-item -path .\c:

Este comando usa el cmdlet New-Item para crear la función "HKLM:". La expresión especificada entre llaves es el bloque de script que representa el nombre de la función.

new-item -path function:hklm: -value {set-location hklm:}

También se puede crear una función con solo escribirla en la línea de comandos de Windows PowerShell. Por ejemplo, escriba "function:hklm: {set-location hklm:}". Si se encuentra en la unidad Function:, puede omitir el nombre de la unidad. Dado que no se puede especificar la etiqueta "Filter" en New-Item, los filtros se etiquetan como funciones, pero funcionan correctamente con cualquier etiqueta. Para crear un filtro con la etiqueta "Filter", escriba el filtro en la línea de comandos. Por ejemplo, escriba "filter:Running {$_.Status -eq "Running"}".

Este comando usa el cmdlet New-Item para crear la función Csrss. Usa el parámetro dinámico Options para especificar el valor ReadOnly para la propiedad Options de la función.

new-item -path function: -name csrss -options readonly -value {get-process csrss}

Este comando se puede usar desde cualquier ubicación. Si se encuentra en la unidad Function:, puede utilizar un punto (.) para especificar la ruta de acceso. El punto representa la ubicación actual.

Este comando elimina la función "hklm:" de la sesión actual.

remove-item function:hklm:

Este comando elimina todas las funciones de la sesión actual, excepto aquellas cuyo valor de la propiedad Options sea Constant. Sin el parámetro Force, el comando no elimina las funciones cuya propiedad Options tenga el valor ReadOnly.

remove-item function:* -force

Si se eliminan todas las funciones, el símbolo del sistema cambia porque se elimina la función prompt, que define el contenido del símbolo del sistema.

Este comando usa el cmdlet Get-Item para obtener todas las funciones. El operador de canalización envía los resultados al cmdlet Get-Member, que muestra los métodos y las propiedades del objeto.

get-item -path function:* | get-member

Cuando se canaliza una colección de objetos a Get-Member (por ejemplo, la colección de funciones de la unidad Function:), Get-Member evalúa cada objeto de la colección por separado y devuelve información acerca de cada tipo de objeto que encuentra. Si todos los objetos son del mismo tipo, devuelve información acerca del único tipo de objeto. En este caso, todas las funciones son objetos FunctionInfo. Para obtener información acerca de la colección de objetos FunctionInfo, se utiliza el parámetro InputObject de Get-Member. Por ejemplo, escriba "get-member -InputObject (get-item function:*)". Si se usa el parámetro InputObject, Get-Member evalúa la colección, no los objetos que esta contiene.

Este comando enumera los valores de las propiedades de la función "prompt". Usa el cmdlet Get-Item para obtener un objeto que representa la función "prompt". El operador de canalización (|) envía los resultados al comando Format-List. El comando Format-List usa el parámetro Property con un carácter comodín (*) para dar formato y mostrar los valores de todas las propiedades de la función "prompt".

get-item function:prompt | format-list -property *

Se puede usar el cmdlet Set-Item con el parámetro dinámico Options para cambiar el valor de la propiedad Options de una función.

Este comando establece las opciones AllScope y ReadOnly de la función "prompt". Este comando usa el parámetro dinámico Options del cmdlet Set-Item. El parámetro Options está disponible en Set-Item únicamente cuando se usa con el proveedor Alias o Function.

set-item -path function:prompt -options "AllScope,ReadOnly"

Este comando usa el cmdlet Set-Item para cambiar la función "prompt" de manera que muestre la hora delante de la ruta de acceso.

set-item -path function:prompt -value {'PS '+ $(Get-Date -format t) + " " + $(Get-Location) + '> '}

El cambio afecta a las propiedades Definition y ScriptBlock del objeto FunctionInfo. Para ver el efecto del cambio, escriba "get-item -path function:prompt | format-list -property *".

Este comando usa el cmdlet Rename-Item para cambiar el nombre de la función "help" a "gh".

rename-item -path function:help -newname gh

Este comando copia la función "prompt" en "oldPrompt", creándose así en realidad un nuevo nombre para el bloque de script que está asociado a la función "prompt". Puede usarlo para guardar la función "prompt" original, si tiene pensado cambiarla.

El valor de la propiedad Options de la nueva función es None. Para cambiar el valor de la propiedad Options, se utiliza Set-Item.

copy-item -path function:prompt -destination function:oldPrompt