Partager via

Out-Null

  • Référence
Module:
Microsoft.PowerShell.Core

Masque la sortie au lieu de l’envoyer dans le pipeline ou de l’afficher.

Syntaxe

Out-Null
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

L’applet Out-Null de commande envoie sa sortie à NULL, en effet, en la supprimant du pipeline et empêchant l’affichage de la sortie à l’écran. Cela affecte uniquement le flux de sortie standard. D’autres flux de sortie, comme le flux d’erreur, ne sont pas affectés. Les exceptions sont affichées. Cela facilite le test de votre commande pour toutes les erreurs.

Exemples

Exemple 1 : Supprimer la sortie

Get-ChildItem | Out-Null

Cette commande obtient des éléments dans l’emplacement/le répertoire actuel, mais sa sortie n’est pas passée par le pipeline ni affichée sur la ligne de commande. Cela est utile pour masquer la sortie dont vous n’avez pas besoin.

Paramètres

-InputObject

Spécifie l’objet à envoyer à NULL (supprimé du pipeline). Entrez une variable contenant les objets, ou tapez une commande ou une expression qui obtient ces 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

Entrées

PSObject

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

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

  • Les applets de commande qui contiennent le verbe Out ( 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 un opérateur de pipeline (|) pour envoyer la sortie d’une commande Windows 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. Pour plus d’informations, voir les exemples.
  • Out-Null ne retourne aucun objet de sortie. Si vous dirigez la sortie vers l’applet de Out-Null commande Get-Member, Get-Member indique qu’aucun objet n’a été spécifié.