Out-Host

  • Riferimento
Modulo:
Microsoft.PowerShell.Core

Invia l'output alla riga di comando.

Sintassi

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

Descrizione

Il Out-Host cmdlet invia l'output all'host di PowerShell per la visualizzazione. L'host visualizza l'output nella riga di comando. Poiché Out-Host è l'impostazione predefinita, non è necessario specificarla a meno che non si voglia usare i relativi parametri.

Out-Host viene aggiunto automaticamente a ogni comando eseguito. Passa l'output della pipeline all'host che esegue il comando . Out-Host ignora le sequenze di escape ANSI. Le sequenze di escape vengono gestite dall'host. Out-Host passa sequenze di escape ANSI all'host senza tentare di interpretarle o modificarle.

Esempio

Esempio 1: Visualizzare l'output di una pagina alla volta

In questo esempio vengono visualizzati i processi di sistema una pagina alla volta.

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 ottiene i processi di sistema e invia gli oggetti verso il basso nella pipeline. Out-Host usa il parametro Paging per visualizzare una pagina di dati alla volta.

Esempio 2: Usare una variabile come input

In questo esempio vengono usati oggetti archiviati in una variabile come input per Out-Host.

$io = Get-History
Out-Host -InputObject $io

Get-History ottiene la cronologia della sessione di PowerShell e archivia gli oggetti nella $io variabile . Out-Host usa il parametro InputObject per specificare la $io variabile e visualizza la cronologia.

Parametri

-InputObject

Specifica gli oggetti che vengono scritti nella console. Immettere una variabile che contiene gli oggetti oppure digitare un comando o un'espressione che ottiene gli oggetti.

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

-Paging

Indica che Out-Host visualizza una pagina di output alla volta e attende l'input dell'utente prima che vengano visualizzate le pagine rimanenti. Per impostazione predefinita, tutto l'output viene visualizzato in una singola pagina. Le dimensioni della pagina vengono determinate dalle caratteristiche dell'host.

Premere la barra spaziatrice per visualizzare la pagina successiva dell'output o il tasto INVIO per visualizzare la riga di output successiva. Premere Q per uscire.

Il paging è simile al comando più .

Nota

Il parametro Paging non è supportato dall'host di PowerShell I edizione Standard.

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

Input

PSObject

È possibile inviare tramite pipe qualsiasi oggetto a questo cmdlet.

Output

None

Questo cmdlet non restituisce output. Invia oggetti all'host per la visualizzazione.

Note

PowerShell include gli alias seguenti per Out-Host:

  • Tutte le piattaforme:
    • oh

Il parametro Paging non è supportato da tutti gli host di PowerShell. Ad esempio, se si usa il parametro Paging in PowerShell I edizione Standard, viene visualizzato l'errore seguente:out-lineoutput : The method or operation is not implemented.

I cmdlet che contengono il verbo Out , Out-, non formattano gli oggetti. Eseguono il rendering degli oggetti e li inviano alla destinazione di visualizzazione specificata. Se si invia un oggetto non formattato a un Out- cmdlet, il cmdlet lo invia a un cmdlet di formattazione prima di eseguire il rendering.

I Out- cmdlet non hanno parametri per i nomi o i percorsi di file. Per inviare dati a un Out- cmdlet, usare la pipeline per inviare l'output di un comando di PowerShell al cmdlet . In alternativa, è possibile archiviare i dati in una variabile e usare il parametro InputObject per passare i dati al cmdlet.

Out-Host invia dati, ma non produce oggetti di output. Se si esegue la pipeline dell'output di Out-Host nel Get-Member cmdlet , Get-Member segnala che non sono stati specificati oggetti.