about_Output_Streams
Explica la disponibilidad y el propósito de los flujos de salida en PowerShell.
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, vea about_Redirection.
PowerShell admite los siguientes flujos de salida.
| Corriente # | Descripción | Introducido en | Write Cmdlet |
|---|---|---|---|
| 1 | flujo de Success | PowerShell 2.0 | Write-Output |
| 2 | flujo de Error | PowerShell 2.0 | Write-Error |
| 3 | flujo de Warning | PowerShell 2.0 | Write-Warning |
| 4 | flujo de Verbose | PowerShell 2.0 | Write-Verbose |
| 5 | flujo de Debug | PowerShell 2.0 | Write-Debug |
| 6 | flujo de Information | PowerShell 5.0 | Write-Information |
| n/a | flujo de Progress | PowerShell 2.0 | Write-Progress |
Nota
La secuencia de Progress no admite el redireccionamiento.
La secuencia de Success es la secuencia predeterminada para los resultados normales y correctos.
Use el cmdlet Write-Output para escribir explícitamente objetos en esta secuencia. Esta secuencia se usa para pasar objetos a través de la canalización de PowerShell. El flujo de Success está conectado al flujo de stdout de para aplicaciones nativas.
El flujo de Error es el flujo predeterminado para los resultados del error. Use el cmdlet Write-Error para escribir explícitamente en esta secuencia. El flujo de Error está conectado al flujo de stderr de para aplicaciones nativas. En la mayoría de las condiciones, estos errores pueden finalizar la canalización de ejecución. Los errores escritos en esta secuencia también se agregan a la variable automática $Error. Para obtener más información, vea about_Automatic_Variables.
La secuencia de Warning está pensada para las condiciones de error que son menos graves que los errores escritos en el flujo de Error. En condiciones normales, estas advertencias no finalizan la ejecución. Las advertencias no se escriben en la variable automática $Error. Use el cmdlet Write-Warning para escribir explícitamente en esta secuencia.
La secuencia de Verbose 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 cmdlet Write-Verbose 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 parámetro común -Verbose. Para obtener más información, vea about_CommonParameters.
El flujo de Debug se usa para los mensajes que ayudan a los scripters a comprender por qué se produce un error en el código. Use el cmdlet Write-Debug para escribir explícitamente en esta secuencia. Los mensajes de depuración solo se generan cuando se usa el parámetro -Debug común. Para obtener más información, vea about_CommonParameters.
Debug 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.
La secuencia de Information 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 cmdlet Write-Information para escribir explícitamente en esta secuencia.
Write-Host también escribe en la secuencia de Information. La diferencia entre los cmdlets es que Write-Host también escribe en la consola host a menos que redirija la secuencia de Information.
Write-Information solo escribe en la secuencia de Information.
La secuencia de Progress se usa para los mensajes que comunican el progreso en scripts y comandos de ejecución más largos. Use el cmdlet Write-Progress para escribir explícitamente mensajes en esta secuencia. La secuencia de Progress no admite el redireccionamiento.
- about_CommonParameters
- about_Redirection
- escritura Debug
- escritura Error
- de host de escritura
- escritura Information
- de salida de escritura
- escritura Progress
- escritura Verbose
- escritura Warning
Comentarios de PowerShell
PowerShell es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: