Out-Host
Envía la salida a la línea de comandos.
Sintaxis
Out-Host
[-Paging]
[-InputObject <PSObject>]
[<CommonParameters>]Description
El cmdlet Out-Host envía la salida al host de PowerShell para su visualización. El host muestra la salida en la línea de comandos. Dado que Out-Host es el valor predeterminado, no es necesario especificarlo a menos que quiera usar sus parámetros.
Out-Host pasa la salida de la canalización al host que ejecuta el comando .
Out-Host omite las secuencias de escape ANSI. El host controla las secuencias de escape.
Out-Host pasa secuencias de escape ANSI al host sin intentar interpretarlas ni cambiarlas.
Ejemplos
Ejemplo 1: Mostrar la salida de una página a la vez
En este ejemplo se muestra que el sistema procesa una página cada vez.
Get-Process | Out-Host -Paging
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
30 24.12 36.95 15.86 21004 14 ApplicationFrameHost
55 24.33 60.48 10.80 12904 14 BCompare
<SPACE> next page; <CR> next line; Q quit
9 4.71 8.94 0.00 16864 14 explorer
<SPACE> next page; <CR> next line; Q quit
Get-Process obtiene los procesos del sistema y envía los objetos a la canalización.
Out-Host usa el parámetro paginación de para mostrar una página de datos a la vez.
Ejemplo 2: Usar una variable como entrada
En este ejemplo se usan objetos almacenados en una variable como entrada para Out-Host.
$io = Get-History
Out-Host -InputObject $io
Get-History obtiene el historial de la sesión de PowerShell y almacena los objetos en la variable $io.
Out-Host usa el parámetro InputObject para especificar la variable $io y muestra el historial.
Parámetros
-InputObject
Especifica los objetos que se escriben en la consola. Escriba una variable que contenga los objetos, o escriba un comando o expresión que obtenga los objetos.
| Tipo: | PSObject |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-Paging
Indica que Out-Host muestra una página de salida a la vez. El tamaño de página viene determinado por las características del host.
Después de generar la primera página, el comando espera la entrada del usuario antes de que se muestren las páginas restantes. Presione la barra espaciadora para mostrar la siguiente página de salida o la tecla Entrar para ver la siguiente línea de salida. Presione Q para salir.
El uso de Paginación es similar al uso del comando más .
Nota
El parámetro Paging no es compatible con el host de PowerShell ISE.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
Puede canalizar cualquier objeto a este cmdlet.
Salidas
None
Este cmdlet no devuelve ninguna salida. Envía objetos al host para su presentación.
Notas
PowerShell incluye los siguientes alias para Out-Host:
- Todas las plataformas:
oh
No todos los hosts de PowerShell admiten el parámetro Paging . Por ejemplo, si usa el parámetro Paging en Windows PowerShell ISE, se muestra el siguiente error:
out-lineoutput: el método o la operación no se implementa.
Los cmdlets que contienen el verbo Out, Out-, no da formato a los objetos. Representan objetos y los envían al destino de presentación especificado. Si envía un objeto sin formato a un cmdlet de Out-, el cmdlet lo envía a un cmdlet de formato antes de representarlo.
Los Out- cmdlets no leen la entrada de los archivos. Para enviar datos a un Out- cmdlet, use la canalización para enviar datos al cmdlet . O bien, puede almacenar datos en una variable y usar el parámetro InputObject para pasar los datos al cmdlet .
Out-Host envía datos solo al host. Tt no genera objetos de salida en la canalización. Si canalizará la salida de Out-Host al cmdlet Get-Member, Get-Member notifica que no se ha especificado ningún objeto.
