Acerca de los flujos de salid

  • Artículo

Descripción breve

Explica la disponibilidad y el propósito de los flujos de salida en PowerShell.

Descripción larga

PowerShell proporciona varios flujos de salida. Las secuencias proporcionan canales para distintos tipos de mensajes. Puede escribir en estas secuencias mediante el cmdlet o redireccionamiento asociados. Para obtener más información, consulte about_Redirection.

PowerShell admite los siguientes flujos de salida.

Corriente # Descripción Introducida en Write Cmdlet
1 Success Corriente PowerShell 2.0 Write-Output
2 Error Corriente PowerShell 2.0 Write-Error
3 Warning Corriente PowerShell 2.0 Write-Warning
4 Verbose Corriente PowerShell 2.0 Write-Verbose
5 Debug Corriente PowerShell 2.0 Write-Debug
6 Information Corriente PowerShell 5.0 Write-Information
N/D Progress Corriente PowerShell 2.0 Write-Progress

Nota:

La Progress secuencia no admite el redireccionamiento.

Success Corriente

La Success secuencia es la secuencia predeterminada para los resultados normales y correctos. Use el Write-Output cmdlet para escribir explícitamente objetos en esta secuencia. Esta secuencia se usa para pasar objetos a través de la canalización de PowerShell. La Success secuencia está conectada al flujo stdout para aplicaciones nativas.

Error Corriente

La Error secuencia es la secuencia predeterminada para los resultados del error. Use el Write-Error cmdlet para escribir explícitamente en esta secuencia. La Error secuencia está conectada al flujo stderr para aplicaciones nativas. En la mayoría de las condiciones, estos errores pueden finalizar la canalización de ejecución. Errorlas s escritas en esta secuencia también se agregan a la $Error variable automática. Para obtener más información, vea about_Automatic_Variables.

Warning Corriente

La Warning secuencia está pensada para condiciones de error que son menos graves que los errores escritos en la Error secuencia. En condiciones normales, estas advertencias no finalizan la ejecución. Warningno se escriben en la $Error variable automática. Use el Write-Warning cmdlet para escribir explícitamente en esta secuencia.

Verbose Corriente

La Verbose secuencia está pensada para mensajes que ayudan a los usuarios a solucionar problemas de comandos a medida que se ejecutan de forma interactiva o desde un script. Use el Write-Verbose cmdlet para escribir explícitamente mensajes en esta secuencia. Muchos cmdlets proporcionan una salida detallada que resulta útil para comprender los trabajos internos del cmdlet. Los mensajes detallados solo se generan cuando se usa el -Verbose parámetro común. Para obtener más información, consulta about_CommonParameters.

Debug Corriente

La Debug secuencia se usa para los mensajes que ayudan a los scripters a comprender por qué se produce un error en el código. Use el Write-Debug cmdlet para escribir explícitamente en esta secuencia. Los mensajes de depuración solo se generan cuando se usa el -Debug parámetro común. Para obtener más información, consulta about_CommonParameters.

Debug los mensajes están diseñados para desarrolladores de scripts y cmdlets más que los usuarios finales. Estos mensajes de depuración pueden contener detalles internos necesarios para la solución de problemas en profundidad.

Information Corriente

La Information secuencia está pensada para proporcionar mensajes que ayuden a un usuario a comprender lo que hace un script. Los desarrolladores también pueden usarlo como una secuencia adicional que se usa para pasar información a través de PowerShell. El desarrollador puede etiquetar los datos de flujo y tener un control específico para esa secuencia. Use el Write-Information cmdlet para escribir explícitamente en esta secuencia.

Write-Host también escribe en la Information secuencia. La diferencia entre los cmdlets es que también escribe en la consola host a menos que Write-Host redirija la Information secuencia. Write-Information solo escribe en la Information secuencia.

Progress Corriente

La Progress secuencia se usa para los mensajes que comunican el progreso en scripts y comandos de ejecución más largos. Use el Write-Progress cmdlet para escribir explícitamente mensajes en esta secuencia. La Progress secuencia no admite el redireccionamiento.

Consulte también