Out-Host
Envía el resultado a la línea de comandos.
Sintaxis
Out-Host [-InputObject <psobject>] [-Paging] [<CommonParameters>]
Descripción
El cmdlet Out-Host envía el resultado al host de Windows PowerShell para su presentación. El host muestra el resultado en la línea de comandos. Dado que Out-Host es el valor predeterminado, no es necesario especificarlo a menos que desee usar sus parámetros para cambiar la presentación.
Parámetros
-InputObject <psobject>
Especifica los objetos que se escriben en la consola. Especifique la variable que contiene los objetos, o bien, escriba un comando o una expresión que obtenga los objetos.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue) |
¿Aceptar caracteres comodín? |
false |
-Paging
Muestra la salida página a página y espera instrucciones del usuario antes de mostrar las páginas restantes, un comportamiento muy similar al del comando "more". De manera predeterminada, todos los resultados aparecen en una única página. El tamaño de la página está determinado por las características del host.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
System.Management.Automation.PSObject Puede canalizar cualquier objeto a Out-Host. |
Salidas |
Ninguno Out-Host no genera resultados. No obstante, el host podría mostrar los objetos que le envía Out-Host. |
Notas
También puede hacer referencia a Out-Host mediante su alias integrado, "oh". Para obtener más información, vea about_Aliases.
Los cmdlets que contienen el verbo Out (cmdlets Out) no dan formato a los objetos; solo los presentan y los envían al destino especificado. Si envía un objeto sin formato a un cmdlet Out, el cmdlet lo enviará a un cmdlet de formato antes de presentarlo.
Los cmdlets Out no tienen parámetros para los nombres o las rutas de archivos. Si desea enviar datos a un cmdlet Out, use el operador de canalización (|) para enviar el resultado de un comando de Windows PowerShell al cmdlet. También puede almacenar los datos en una variable y usar el parámetro InputObject para pasar los datos al cmdlet. Para obtener ayuda, vea los ejemplos.
Out-Host envía los datos, pero no emite objetos de salida. Si canaliza el resultado de Out-Host a Get-Member, Get-Member notificará que no se ha especificado ningún objeto.
Ejemplo 1
C:\PS>get-process | out-host -paging
Descripción
-----------
Este comando muestra los procesos del sistema, página a página. Usa el comando Get-Process para obtener los procesos del sistema. El operador de canalización (|) envía los resultados al cmdlet Out-Host, que los muestra en la consola. El parámetro Paging muestra una página de datos cada vez.
El mismo formato de comando se usa para la función Help que está integrada en Windows PowerShell. Esta función obtiene datos de Get-Help y, a continuación, usa el parámetro Paging de Out-Host para mostrar los datos en una página a la vez con este formato de comando: get-help $args[0] | out-host -paging).
Ejemplo 2
C:\PS>$a = get-history
C:\PS>out-host -InputObject $a
Descripción
-----------
Estos comandos muestran el historial de sesiones en la línea de comandos. El primer comando usa el cmdlet Get-History para obtener el historial de sesiones y, a continuación, almacena el historial en la variable $a. El segundo comando usa Out-Host para mostrar el contenido de la variable $a y usa el parámetro InputObject para especificar la variable en Out-Host.
Vea también
Conceptos
Out-Printer
Out-Null
Out-File
Out-String
Out-Default
Write-Host