Incorporación de una salida a scripts de Windows PowerShell

Completado

Cuando un script no funciona según lo esperado, puede resultar útil que el script muestre información adicional. Puede usar esa información para comprender lo que hace el script y por qué no funciona según lo previsto.

El cmdlet Write-Host es la manera más común de mostrar información adicional mientras se ejecuta un script. Puede usar Write-Host para mostrar información de texto que indique puntos específicos en un script y valores de variable. Los valores de variable pueden ser útiles en la mayoría de los casos cuando un script no se comporta según lo esperado, ya que las variables no tienen valores previstos.

Si desea que el texto de solución de problemas se identifique más fácilmente, puede usar el cmdlet Write-Warning en lugar de Write-Host. Write-Warning muestra el texto que especifique en un color alternativo.

Si desea ralentizar la ejecución de un script para poder revisar mejor la salida, puede agregar un cmdlet Start-Sleep y especificar unos segundos para pausar. Como alternativa, si desea que el script se detenga hasta que esté listo para continuar, puede usar Read-Host.

Durante la solución de problemas, puede comentar la información adicional. Después, si es necesario, puede anular la marca de comentario para volver a revisar la información adicional.

Salida de script avanzada

Si ha configurado el script como script avanzado mediante CmdletBinding() en el bloque Param(), también puede usar los cmdlets de la tabla siguiente como parte del script para la solución de problemas.

Tabla 1: Cmdlets para la solución de problemas

Cmdlet	Descripción
Write-Verbose	El texto especificado por Write-Verbose solo se muestra cuando se usa el parámetro -Verbose al ejecutar el script. El valor de $VerbosePreference especifica la acción que se realizará después del comando Write-Verbose. La acción predeterminada es SilentlyContinue.
Write-Debug	El texto especificado por Write-Debug solo se muestra cuando se usa el parámetro -Debug al ejecutar el script. El valor de $DebugPreference especifica la acción que se realizará después del comando Write-Debug. La acción predeterminada es SilentlyContinue, que no muestra información en la pantalla. Debe cambiar esta acción a Continue para que se muestren los mensajes de depuración.