Acerca de los flujos de salid
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 informationinformació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 error resultados. 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. Los errores escritos en esta secuencia también se agregan a la $Error variable automática. Para obtener más informationinformación, consulte about_Automatic_Variables.
Warning corriente
La Warning secuencia está pensada para error condiciones que son menos graves que los errores escritos en la Error secuencia. En condiciones normales, estas advertencias no finalizan la ejecución. Las advertencias no 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 verbose una salida que resulta útil para comprender los trabajos internos del cmdlet. Los verbose mensajes solo se generan cuando se usa el -Verbose parámetro común. Para obtener más informationinformación, consulte 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 debug mensajes solo se generan cuando se usa el -Debug parámetro común. Para obtener más informationinformación, consulte about_CommonParameters.
Debug los mensajes están diseñados para desarrolladores de scripts y cmdlets más que los usuarios finales. Estos debug mensajes pueden contener detalles internos necesarios para solucionar problemas profundos.
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 information 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 se comunican progress 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.
