Out-Host

Référence

Module:: Microsoft.PowerShell.Core

Envoie la sortie à la ligne de commande.

Syntaxe

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

Description

L’applet de commande Out-Host envoie la sortie à l’hôte PowerShell pour l’affichage. L’hôte affiche la sortie sur la ligne de commande. Étant donné que Out-Host est la valeur par défaut, vous n’avez pas à le spécifier, sauf si vous souhaitez utiliser ses paramètres.

Out-Host transmet la sortie du pipeline à l’hôte exécutant la commande. Out-Host ignore les séquences d’échappement ANSI. Les séquences d’échappement sont gérées par l’hôte. Out-Host passe des séquences d’échappement ANSI à l’hôte sans essayer de les interpréter ou de les modifier.

Exemples

Exemple 1 : Afficher la sortie d’une page à la fois

Cet exemple montre comment afficher les processus système d’une page à la fois.

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 obtient les processus système et envoie les objets vers le bas du pipeline. Out-Host utilise le paramètre pagination pour afficher une page de données à la fois.

Exemple 2 : Utiliser une variable comme entrée

Cet exemple utilise des objets stockés dans une variable comme entrée pour Out-Host.

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

Get-History obtient l’historique de la session PowerShell et stocke les objets dans la variable $io. Out-Host utilise le paramètre InputObject pour spécifier la variable $io et afficher l’historique.

Paramètres

-InputObject

Spécifie les objets écrits dans la console. Entrez une variable qui contient les objets, ou tapez une commande ou une expression qui obtient les objets.

Type:	PSObject
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Paging

Indique qu’une Out-Host page de sortie s’affiche à la fois. La taille de la page est déterminée par les caractéristiques de l’hôte.

Après avoir sorti la première page, la commande attend l’entrée de l’utilisateur avant l’affichage des pages restantes. Appuyez sur Espace pour afficher la page suivante de sortie ou la touche Entrée pour afficher la ligne de sortie suivante. Appuyez sur Q pour quitter.

L’utilisation de la pagination est similaire à l’utilisation de la commande plus .

Note

Le paramètre pagination n’est pas pris en charge par l’hôte POWERShell ISE.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

PSObject

Vous pouvez diriger n’importe quel objet vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne aucune sortie. Il envoie des objets à l’hôte pour l’affichage.

Notes

Windows PowerShell inclut les alias suivants pour Out-Host:

oh

Tous les hôtes PowerShell ne prennent pas en charge le paramètre pagination . Par exemple, si vous utilisez le paramètre Pagination dans Windows PowerShell ISE, l’erreur suivante s’affiche :

out-lineoutput : la méthode ou l’opération n’est pas implémentée.

Les applets de commande qui contiennent le verbe Out, Out-, ne mettez pas en forme les objets. Ils affichent des objets et les envoient à la destination d’affichage spécifiée. Si vous envoyez un objet non mis en forme à une applet de commande Out-, l’applet de commande l’envoie à une applet de commande de mise en forme avant de la rendre.

Les Out- applets de commande ne lisent pas d’entrée à partir de fichiers. Pour envoyer des données à une Out- applet de commande, utilisez le pipeline pour envoyer des données à l’applet de commande. Vous pouvez également stocker des données dans une variable et utiliser le paramètre InputObject pour transmettre les données à l’applet de commande.

Out-Host envoie des données à l’hôte uniquement. Tt ne produit pas d’objets de sortie dans le pipeline. Si vous pipelinez la sortie de Out-Host vers l’applet de commande Get-Member, Get-Member signale qu’aucun objet n’a été spécifié.

Partager via