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 Name, Noun y Verb aceptan caracteres comodín. En el ejemplo siguiente se muestran los caracteres comodín que se usan con el parámetro Name:
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.
Recent Comments