Out-Host
Envoie la sortie à la ligne de commande.
Syntaxe
All
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 est automatiquement ajouté à chaque commande exécutée. Il 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.
Propriétés du paramètre
| Type: | PSObject |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Paging
Indique que Out-Host affiche une page de sortie à la fois et attend l’entrée de l’utilisateur avant que les pages restantes ne soient affichées. Par défaut, toutes les sorties sont affichées sur une seule page. La taille de la page est déterminée par les caractéristiques de l’hôte.
Appuyez sur la barre d’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.
de pagination est similaire à la commande plus.
Remarque
Le paramètre pagination n’est pas pris en charge par l’hôte POWERShell ISE.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Entrées
PSObject
Vous pouvez envoyer des objets dans le pipeline à Out-Host.
Sorties
None
Out-Host ne génère aucune sortie. Il envoie des objets à l’hôte pour l’affichage.
Notes
Le paramètre pagination n’est pas pris en charge par tous les hôtes PowerShell. Par exemple, si vous utilisez le paramètre pagination dans PowerShell ISE, l’erreur suivante s’affiche : out-lineoutput : The method or operation is not implemented.
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 applets de commande Out- n’ont pas de paramètres pour les noms ou les chemins d’accès aux fichiers. Pour envoyer des données à une applet de commande Out-, utilisez le pipeline pour envoyer la sortie d’une commande PowerShell à 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, mais elle ne produit aucun objet de sortie. 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é.