Capítulo 1: ¿Qué es PowerShell?

Publicado por P. Ruiz en

Obtener más ayuda

Si te fijas en la imagen anterior, Get-Help nos avisa de que no está encontrando los archivos de ayuda y sólo se está mostrando una parte. Además, el propio cmdlet nos indica tres formas distintas de obtener la ayuda que nos falta:

  1. Añadir a la sintaxis el argumento -Online, con lo que Get-Help buscará la información que le falta en la página de Microsoft:

    Get-Help -Online Get-ChildItem

    Escribimos la orden y pulsamos la tecla Intro.

    PowerShell-017

    Al hacerlo, se abrirá una nueva ventana del navegador web y, en su interior, se mostrará la página con la documentación oficial completa del cmdlet que estamos consultando.

    Documentación de Get-ChildItem.

    PowerShell-018

  2. Utilizar directamente en el navegador web la URL que nos ofrece Get-Help (para nuestro ejemplo, http://go.microsoft.com/fwlink/?LinkID=113308, aunque variará en función del cmdlet consultado).

    Esto nos llevará exactamente a la misma página web de la imagen anterior.

  3. Instalar los archivos de ayuda de forma local. Algo que será particularmente útil si no vamos a tener conexión a Internet de manera continua en nuestro equipo.

    La instalación de módulos de ayuda deben realizarse desde una ventana de PowerShell con privilegios administrativos.

    Para lograrlo, recurriremos al cmdlet Update-Help. Sin embargo, si lo utilizamos sin argumentos, como indica la ayuda el propio Get-Help, instalaremos una gran cantidad de información.

    Por ese motivo, nosotros aquí instalaremos únicamente los módulos relacionados con PowerShell. Para lograrlo, sólo tenemos que incluir el argumento -Module seguido del nombre de los módulos de ayuda a instalar (en nuestro caso, todos los relacionados con PowerShell):

    Update-Help -Module Microsoft.PowerShell*

    Como de costumbre, escribimos la orden y pulsamos la tecla Intro.

    PowerShell-019

    Al hacerlo, el sistema pasará unos minutos descargando e instalando los archivos de ayuda de diferentes módulos

    Sólo tenemos que esperar unos instantes

    PowerShell-020

    Puede que al final de la instalación, el sistema te avise de que algunos de los módulos de ayuda no se ha instalado satisfactoriamente. No debes preocuparte en exceso porque suelen ser módulos poco utilizados.

    Si ahora volvemos a utilizar la sintaxis original de Get-Help, obtendremos una salida mucho más detallada que al principio:

    Get-Help Get-ChildItem

    Nueva salida de Get-ChildItem.

    PowerShell-021

    Como antes, en la parte final de la salida, nos recomiendan otros alternativas. Por ejemplo:

    Get-Help Get-ChildItem -Detailed

    Así, obtenemos una información aún más extendida

    PowerShell-022

    … O la opción:

    Get-Help Get-ChildItem -Examples

    … que nos ofrece ejemplos de uso del cmdlet.

    PowerShell-023

    Incluso podemos obtener información detallada de cada argumento usando el argumento -Full:

    Get-Help Get-ChildItem -Full

    En este caso, la salida es extensa y detallada.

    PowerShell-024