Partager via

Out-Printer

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

Envoie la sortie à une imprimante.

Syntaxe

Out-Printer
   [[-Name] <String>]
   [-InputObject <PSObject>]
   [<CommonParameters>]

Description

L’applet de commande Out-Printer envoie la sortie à l’imprimante par défaut ou à une autre imprimante, si elle est spécifiée.

Exemples

Exemple 1 : Imprimer le contenu d’une rubrique d’aide sur l’imprimante par défaut

PS C:\> Get-Content $pshome\about_signing.help.txt | Out-Printer

Cette commande imprime le contenu de la rubrique d’aide about_Signing sur l’imprimante par défaut. Cet exemple montre comment imprimer un fichier, même si out-Printer n’a pas de paramètre Path.

La commande utilise l’applet de commande Get-Content pour obtenir le contenu de la rubrique d’aide. Le chemin inclut $pshome, variable intégrée qui stocke le répertoire d’installation pour Windows PowerShell. Un opérateur de pipeline (|) transmet les résultats à Out-Printer, qui l’envoie à l’imprimante par défaut.

Exemple 2 : Imprimer du texte sur une autre imprimante

PS C:\> "Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

Cette commande imprime Hello, World sur l’imprimante De couleur Prt-6B sur Server01. Cette commande utilise le paramètre Name pour spécifier l’autre imprimante. Étant donné que le nom du paramètre est facultatif, vous pouvez l’omettre.

Exemple 3 : Imprimer la version complète d’une rubrique d’aide sur l’imprimante par défaut

PS C:\> $H = Get-Help -Full Get-WmiObject
PS C:\> Out-Printer -InputObject $H

Ces commandes impriment la version complète de la rubrique d’aide pour Get-WmiObject. La première commande utilise l’applet de commande Get-Help pour obtenir la version complète de la rubrique d’aide pour Get-WmiObject et la stocke dans la variable $H. La deuxième commande envoie le contenu à l’imprimante par défaut. Il utilise le paramètre InputObject pour passer la valeur de la variable $H à Out-Printer .

Paramètres

-InputObject

Spécifie les objets à envoyer à l’imprimante. 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

-Name

Spécifie l’autre imprimante. Le nom du paramètre Nom est facultatif.

Type:String
Alias:PrinterName
Position:0
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 Out-Printer .

Sorties

None

Out-Printer ne retourne aucun objet.

Notes

  • Vous pouvez également faire référence à Out-Printer par son alias intégré, lp. Pour plus d’informations, consultez about_Aliases.

    Les applets de commande qui contiennent le verbe Out ne mettez pas en forme les objets ; ils les affichent 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 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, consultez les exemples.

    out-Printer envoie des données, mais elle n’émet aucun objet de sortie. Si vous dirigez la sortie de out-printer vers Get-Member, get-member signale qu’aucun objet n’a été spécifié.