HOWTO · PowerShell
El equivalente de echo en PowerShell
Este tutorial presentará comandos equivalentes a echo en PowerShell para scripts y funciones.
En esta página
En PowerShell, echo es un alias de Write-Output. Puedes usarlo o llamar directamente a Write-Output para enviar un valor al flujo de salida de éxito. Si ningún otro comando recibe ese valor mediante una canalización, el shell interactivo lo muestra. Para mensajes dirigidos únicamente a una persona en la consola, usa Write-Host; para diagnósticos opcionales, usa Write-Debug o Write-Verbose.
Ejecuta este ejemplo. El comando y el texto que muestra permanecen en inglés para conservar el código original.
Write-Output "Hello World!"
¿Qué comando de PowerShell sustituye a echo?
echo es un alias práctico de Write-Output, así que los scripts existentes que usan echo "Hello World!" envían la cadena al mismo flujo de salida. En los scripts reutilizables, escribir Write-Output de forma explícita facilita reconocer qué hace el código. Es el equivalente más cercano en PowerShell cuando quieres un valor que se pueda mostrar o pasar a otro comando.
Enviar salida por la canalización con Write-Output
Write-Output escribe un objeto en el flujo de salida de éxito de PowerShell. El shell lo muestra si ningún comando lo consume, pero una canalización puede procesarlo en su lugar. Por ejemplo, Write-Output "Hello World!" | Set-Content -Path message.txt envía la cadena al siguiente comando, en vez de mostrarla como resultado final. Normalmente basta con pasar el valor como argumento; no hace falta indicar por nombre el parámetro -InputObject.
Elige este cmdlet cuando una función deba devolver datos a quien la llama o cuando una etapa posterior de la canalización tenga que filtrar, transformar o guardar el valor. Evita la presentación exclusiva en el host para los datos que quien llama necesite capturar.
Escribir directamente en la consola con Write-Host
Usa Write-Host "Hello World!" para mostrar un mensaje directamente mediante el host de PowerShell actual. Sirve para presentar información a la persona que usa la consola, como una breve indicación de progreso o un mensaje de estado en color. La cadena no se envía por el flujo de salida de éxito para que quien llama la procese como datos ordinarios de la canalización.
Write-Host no requiere que indiques explícitamente el parámetro -Object. Prefiere Write-Output para los valores que deban devolver los scripts o las funciones; usa Write-Host cuando el objetivo sea mostrar el mensaje.
Usar Write-Debug y Write-Verbose para mensajes de diagnóstico
Los mensajes de diagnóstico se separan de la salida de éxito habitual. Write-Debug "Checking configuration" identifica un mensaje como información de depuración, mientras que Write-Verbose "Loading configuration" lo identifica como un detalle operativo adicional. La visibilidad de cada tipo se controla por separado mediante $DebugPreference y $VerbosePreference.
El valor predeterminado de $DebugPreference es SilentlyContinue, por lo que los mensajes de depuración suelen permanecer ocultos. Si estableces $DebugPreference = "Continue", se mostrarán mientras el script continúa ejecutándose. Del mismo modo, establecer $VerbosePreference = "Continue" muestra los mensajes de Write-Verbose. En funciones y scripts avanzados, quien los llama suele poder activar los mensajes detallados con el parámetro común -Verbose. Usa el tipo de diagnóstico adecuado; no presentes la salida habitual como texto de depuración o detallado.
Mostrar directamente un literal de cadena
Una cadena entre comillas usada como expresión de PowerShell también produce un valor en el flujo de salida de éxito. Para una comprobación interactiva rápida, escribe "Hello World!" en el indicador de comandos. Esta forma concisa resulta práctica para probar un valor, aunque una llamada explícita a Write-Output puede dejar más clara la intención en un script extenso. Como cualquier otro valor del flujo de salida de éxito, la cadena se puede capturar o pasar por una canalización en vez de mostrarse de inmediato.
Elegir el método de salida adecuado
Elige según quién o qué deba recibir el mensaje:
- Usa
Write-Output(o su aliasecho) para producir datos destinados a quien llama, a la canalización o a la visualización del shell. - Usa
Write-Hostpara mostrar algo en el host que no deba devolverse como datos de la canalización. - Usa
Write-Debugpara diagnósticos de depuración yWrite-Verbosepara detalles operativos opcionales; activa cada uno mediante su propio control de preferencia o un parámetro común compatible. - Usa una cadena entre comillas sin más para una expresión rápida en el indicador interactivo.
Estos métodos no son intercambiables. Si quien llama a una función necesita capturar, transformar o redirigir un valor, envíalo por el flujo de salida de éxito. Reserva la presentación directa en el host y los flujos de diagnóstico para los mensajes cuyo propósito sea informar a una persona, no proporcionar el resultado de la función.