Out-Host

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Envía los resultados a la línea de comandos.

Syntax

Out-Host
   [-Paging]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

El Out-Host cmdlet envía la salida al host de PowerShell para su visualización. El host muestra los resultados en la línea de comandos. Dado Out-Host que es el valor predeterminado, no es necesario especificarlo a menos que quiera usar sus parámetros.

Out-Host se anexa automáticamente a cada comando que se ejecuta. 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 Paging 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 $io variable . Out-Host usa el parámetro InputObject para especificar la $io variable y muestra el historial.

Parámetros

-InputObject

Especifica los objetos que se escriben en la consola. Especifique una variable que contenga los objetos o escriba un comando o una expresión que obtenga los objetos.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Paging

Indica que Out-Host muestra una página de salida a la vez y espera la entrada del usuario antes de que se muestren las páginas restantes. De forma predeterminada, toda la salida se muestra en una sola página. El tamaño de página depende de las características del host.

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.

La paginación es similar al comando más .

Nota:

El parámetro Paging no es compatible con el host de PowerShell ISE.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

PSObject

Puede canalizar cualquier objeto a este cmdlet.

Salidas

None

Este cmdlet no devuelve ningún resultado. Envía objetos al host para su presentación.

Notas

PowerShell incluye los siguientes alias para Out-Host:

  • Todas las plataformas:
    • oh

El parámetro Paging no es compatible con todos los hosts de PowerShell. Por ejemplo, si usa el parámetro Paging en PowerShell ISE, se muestra el siguiente error: out-lineoutput : The method or operation is not implemented.

Los cmdlets que contienen el verbo Out , Out-, no formatear objetos. Representan objetos y los envían al destino de presentación especificado. Si envía un objeto sin formato a un Out- cmdlet, el cmdlet lo envía a un cmdlet de formato antes de representarlo.

Los Out- cmdlets no tienen parámetros para nombres ni rutas de acceso de archivo. Para enviar datos a un Out- cmdlet, use la canalización para enviar la salida de un comando de PowerShell 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, pero no genera ningún objeto de salida. Si canalizará la salida del Out-HostGet-Member cmdlet, Get-Member notifica que no se han especificado objetos.