Partager via


Out-Printer

Envoie la sortie vers une imprimante.

Syntax

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

Description

L’applet Out-Printer de commande envoie la sortie à l’imprimante par défaut ou à une autre imprimante, si elle est spécifiée. Étant donné que l’applet de commande n’a aucun moyen de configurer la tâche d’impression, la tâche d’impression résultante utilise les paramètres par défaut définis pour l’imprimante.

Remarque

Cette applet de commande a été réintroduite dans PowerShell 7. Cette applet de commande est disponible uniquement sur les systèmes Windows qui prennent en charge le Bureau Windows.

Exemples

Exemple 1 : Envoyer un fichier à imprimer sur l’imprimante par défaut

Cet exemple montre comment imprimer un fichier, même s’il Out-Printer n’a pas de paramètre Path .

Get-Content -Path ./readme.txt | Out-Printer

Get-Contentobtient le contenu du readme.txt fichier dans le répertoire actif et le dirige vers Out-Printer, qui l’envoie à l’imprimante par défaut.

Exemple 2 : Imprimer une chaîne sur une imprimante distante

Cet exemple montre comment Hello, World imprimer l’imprimante De couleur Prt-6B sur Server01.

"Hello, World" | Out-Printer -Name "\\Server01\Prt-6B Color"

Le paramètre Name sélectionne une imprimante spécifique, plutôt que la valeur par défaut.

Exemple 3 - Imprimer une rubrique d’aide sur l’imprimante par défaut

Cet exemple imprime la version complète de la rubrique d’aide pour Get-CimInstance.

$H = Get-Help -Full Get-CimInstance
Out-Printer -InputObject $H

Get-Help obtient la version complète de la rubrique d’aide pour Get-CimInstance et la stocke dans la $H variable. Le paramètre InputObject transmet la valeur à $HOut-Printer.

Paramètres

-InputObject

Spécifie les objets à envoyer à l'imprimante. Entrez une variable contenant les objets, ou tapez une commande ou une expression qui obtient ces objets.

Type:PSObject
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Envoie la sortie à l’imprimante spécifiée. Le nom du paramètre est facultatif.

Type:String
Aliases:PrinterName
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Windows PowerShell inclut les alias suivants pour Out-Printer:

  • lp

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

Out-Printer envoie des données à l’imprimante, mais n’émet aucun objet de sortie dans le pipeline. Si vous dirigez la sortie vers Out-PrinterGet-Member, Get-Member signale qu’aucun objet n’a été spécifié.