Invia l'output alla riga di comando.

Sintassi

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

Descrizione

Il cmdlet Out-Host invia l'output all'host di Windows PowerShell per la visualizzazione. L'host visualizza l'output sulla riga di comando. Poiché Out-Host rappresenta il valore predefinito, non è necessario specificarlo, a meno che non si desideri utilizzarne i parametri per modificarne la visualizzazione.

Parametri

-InputObject <psobject>

Specifica gli oggetti scritti nella console. Immettere una variabile contenente gli oggetti oppure digitare un comando o un'espressione che consente di ottenere gli oggetti.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

true (ByValue)

Accettare caratteri jolly?

false

-Paging

Visualizza una pagina di output alla volta e attende l'input dell'utente prima di visualizzare le pagine rimanenti, in modo analogo al normale comando "more". Per impostazione predefinita, tutto l'output viene visualizzato in una singola pagina. Le dimensioni della pagina verranno determinate dalle caratteristiche dell'host.

Obbligatorio?

false

Posizione?

named

Valore predefinito

Accettare input da pipeline?

false

Accettare caratteri jolly?

false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

System.Management.Automation.PSObject

È possibile reindirizzare qualsiasi oggetto a Out-Host.

Output

Nessuno

Out-Host non genera alcun output. Tuttavia, l'host potrebbe visualizzare gli oggetti inviati da Out-Host.

Note

È inoltre possibile fare riferimento a Out-Host tramite il relativo alias predefinito "oh". Per ulteriori informazioni, vedere about_Aliases.

I cmdlet che contengono il verbo Out (cmdlet Out) non consentono di formattare gli oggetti ma solo di eseguirne il rendering e di inviarli alla destinazione di visualizzazione specificata. Un oggetto non formattato inviato a un cmdlet di tipo Out verrà inviato a un cmdlet di formattazione prima di eseguirne il rendering.

Con i cmdlet di tipo Out non sono disponibili parametri per nomi o percorsi di file. Per inviare i dati a un cmdlet Out, utilizzare un operatore pipeline (|) per inviare l'output di un comando di Windows PowerShell al cmdlet. È inoltre possibile archiviare i dati in una variabile e utilizzare il parametro InputObject per passare i dati al cmdlet. Per informazioni, vedere gli esempi.

Out-Host invia i dati ma non crea oggetti di output. Se si reindirizza l'output di Out-Host a Get-Member, Get-Member segnalerà che non sono stati specificati oggetti.

Esempio 1

C:\PS>get-process | out-host -paging

Descrizione
-----------
Tramite questo comando le informazioni sui processi disponibili nel sistema verranno visualizzate una pagina per volta. Verrà utilizzato il comando Get-Process per ottenere tutti i processi nel sistema. Verrà quindi utilizzato l'operatore pipeline (|) per inviare i risultati a Out-Host, che li visualizzerà nella console. Tramite il parametro Paging verrà visualizzata una pagina di dati per volta.

Lo stesso formato di comando viene utilizzato per la funzione Help integrata in Windows PowerShell. Tale funzione consente di ottenere dati da Get-Help e successivamente di utilizzare il parametro Paging di Out-Host per visualizzare i dati una pagina alla volta tramite questo formato di comando: get-help $args[0] | out-host -paging).






Esempio 2

C:\PS>$a = get-history

C:\PS>out-host -InputObject $a

Descrizione
-----------
Tramite questi comandi la cronologia della sessione verrà visualizzata sulla riga di comando. Nel primo comando verrà utilizzato il cmdlet Get-History per ottenere la cronologia della sessione, che verrà quindi archiviata nella variabile $a. Nel secondo comando verrà utilizzato Out-Host per visualizzare il contenuto della variabile $a. Verrà quindi utilizzato il parametro InputObject per specificare la variabile per Out-Host.






Vedere anche




Argomenti della Guida