PowerShell: uso de la ayuda (Obtener ayuda)

Don Jones, autor de "Aprenda PowerShell en un mes de almuerzos", dijo:

“Esté preparado para leer la ayuda o fallará en PowerShell. "

Qué gran cita. Juego con él y recuerdo sus palabras cada vez que olvido usar el sistema de ayuda para solucionar problemas.

Descarga del contenido de ayuda

Puede llamar a la ayuda con el cmdlet Get-Help. Esto le brinda la información de que la ayuda solo está disponible en línea. Pero la buena noticia es que puedes descargarlo.

Get-Help

Para usar la ayuda para Get-Childitem sin descargarlo, ejecute

Get-Help Get-ChildItem -Online

Una vez ejecutado aparecerá una ventana del navegador que le mostrará la ayuda en línea.

Volvamos al tema principal. Para descargar ayuda ejecute

Update-Help -UICulture "en-US" -Force

Tenga en cuenta que puede ejecutar el comando sin -Force solo una vez al día.

Usando la ayuda

Get-Help ofrece una amplia gama de parámetros. Escriba Get-Help y luego escriba - y mantenga presionado CTRL + ESPACIO para verlos todos

Para obtener el contenido de ayuda de Get-Childitem simplemente escriba

Get-Help Get-ChildItem

Help Get-ChildItem

Esto muestra la versión pequeña de la Ayuda. Para los principiantes puede resultar frustrante leer la ayuda de esta manera. No ofrece ejemplos ni información detallada sobre el uso del Comando. Sigamos con el parámetro de ejemplo, que es más útil para “aprender haciendo”.

Los ejemplos

Los ejemplos de ayuda de PowerShell son realmente geniales y excelentes para realizar sus primeros pasos con PowerShell. Para obtener los ejemplos de ejecución de Get-ChildItem

Get-Help Get-ChildItem -Examples

y busque el ejemplo 6 y el ejemplo 8

Combínelos para enumerar todos los archivos de texto en el directorio actual por nombre.

Get-ChildItem . -Name -Include *.txt -Recurse -Force

Otro ejemplo muestra cómo utilizar los atributos de Powershell con Get-Date.

Help Get-Date -Online

Desplácese hacia abajo en la ventana del navegador hasta la sección de ejemplos y busque el Ejemplo 4.

Ahora puedes empezar a jugar. Por ejemplo, puedes modificar el comando y completar tu fecha de nacimiento.

Consejo: escriba (Get-Date). luego presione CTRL + ESPACIO. Diviértete mientras exploras los atributos de Get-Date

Ejemplos:

(Get-Date -Year 1976 -Month 03 -Date 23).IsDaylightSavingTime()

(Get-Date).AddDays(300)

o busque un usuario que no haya iniciado sesión en el dominio durante un año:

Get-ADUser -Filter * -Properties LastLogonDate | ? {$_.lastlogondate -ne $null -and $_.lastlogondate -le ((get-date).adddays(-365))} | Format-List Name,LastLogonDate

o busque buzones de correo inactivos:

Get-MailboxStatistics -server server01 | ? {$_.lastlogontime -ne $null -and $_.lastlogontime -le ((get-date).adddays(-365))} | Sort-Object {$_.lastlogontime}

La ayuda completa

Para obtener la ayuda completa, ejecute

Get-Help Get-Date -Full

La ayuda completa muestra todo el tema de ayuda. Esto incluye parámetros, atributos y, por último, pero no menos importante, los ejemplos.

La ayuda detallada

Obtener ayuda con el parámetro Detallado muestra descripciones y ejemplos de parámetros.