Aprender a usar el sistema de ayuda de PowerShell nos permite encontrar los comandos cuando se necesitan y entender cómo usarlos.

Previamente actualizaremos el sistema de ayuda, el cmdlet Update-Help se usa para actualizar los temas. Requiere acceso a Internet de forma predeterminada y que se ejecute PowerShell con privilegios elevados como administrador.

Get-Help

Get-Help es un comando multipropósito. Get-Help le ayuda a aprender a usar comandos una vez que los haya encontrado. Get-Help también se puede usar para facilitar la búsqueda de comandos, pero de una forma diferente y más indirecta en comparación con Get-Command.

Cuando Get-Help se usa para buscar comandos, primero busca coincidencias con caracteres comodín de los nombres de comando en función de la entrada proporcionada. Si no encuentra ninguna coincidencia, busca en los temas de ayuda y, si tampoco se encuentra ninguna coincidencia, se devuelve un error.

Get-Help tambien se puede usar para buscar comandos que no tienen temas de ayuda.

El siguiente cmdlet se usa para mostrar el tema de ayuda de Get-Help.

Cuando se especifica el parámetro Full de Get-Help, se devuelve todo el tema de ayuda.

Dedique un momento a ejecutar ese ejemplo en el equipo, revise el resultado y tome nota del modo en que se agrupa la información:

  • NAME
  • SINOPSIS
  • SINTAXIS
  • DESCRIPTION
  • PARAMETERS
  • ENTRADAS
  • SALIDAS
  • NOTAS
  • EJEMPLOS
  • VÍNCULOS RELACIONADOS

En ocasiones, puede que no desee mostrar el tema de ayuda completo de un comando. Hay algunos otros parámetros además de Full que se pueden especificar con Get-Help o Help. Intente ejecutar los siguientes comandos en el equipo del entorno de laboratorio de Windows 10:

Para usar Get-Help para buscar comandos, use el carácter comodín de asterisco (*) con el parámetro Name. Especifique un término para el que esté buscando comandos como valor para el parámetro Name, tal como se muestra en el ejemplo siguiente.

En el ejemplo anterior, los caracteres comodín * no son necesarios y, si se omiten, se produce el mismo resultado. Get-Help agrega automáticamente los caracteres comodín en segundo plano.

Help de PowerShell puede encontrar comandos que tengan o no temas de ayuda.

Get-Command

Get-Command está diseñado para ayudarle a localizar comandos. Al ejecutar Get-Command sin ningún parámetro, se devuelve una lista de todos los comandos del sistema. En el ejemplo siguiente se muestra cómo usar el cmdlet Get-Command para determinar qué comandos existen para trabajar con procesos:

Observe que, en el ejemplo anterior, en el que se ejecutó Get-Command, se usa el parámetro Noun y se especifica Process como el valor del parámetro Noun. ¿Qué ocurre si no sabe cómo usar el cmdlet Get-Command? Puede usar Get-Help para mostrar el tema de ayuda de Get-Command.

Los parámetros NameNoun y Verb aceptan caracteres comodín. En el ejemplo siguiente se muestran los caracteres comodín que se usan con el parámetro Name:

Si va a utilizar caracteres comodín con el parámetro Name, es recomendable limitar los resultados con el parámetro CommandType.
Una opción mejor es usar el parámetro Verb o Noun o ambos, ya que solo los comandos de PowerShell tienen tanto verbos como sustantivos.

Get-Member

Get-Member ayuda a detectar qué objetos, propiedades y métodos están disponibles para los comandos. Cualquier comando que produzca una salida basada en objetos se puede canalizar a Get-Member.

En el siguiente ejemplo, voy a recuperar información sobre el servicio de Hora de Windows que se ejecuta en mi equipo.

StatusName y DisplayName son ejemplos de propiedades, tal como se muestra en el conjunto de resultados anterior. El valor de la propiedad Status es Running, el valor de la propiedad Name es w32time y el valor de DisplayName es Windows Time.
Ahora canalizamos ese comando a Get-Member:
Una vez que se sepa el tipo de objeto que produce un comando, se puede utilizar esta información para buscar comandos que acepten ese tipo de objeto como entrada.
Todos esos comandos tienen un parámetro que acepta un tipo de objeto ServiceController por canalización, entrada de parámetro o ambos.